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Preface 


Purpose 


This publication describes how to plan and implement: 


¢ A conversion from VM/SP HPO Release 4.2 or 5 to VM/XA SP Release 2 
¢ A conversion from VM/XA SF Release 2 to VM/XA SP Release 2 
e A migration from VM/XA SP Release | to VM/XA SP Release 2. 


This manual does not address CMS application conversion in detail. For that 
information, see VM/XA SP CMS Application Program Conversion Guide. 


Audience 


This publication is for system programmers, system analysts, and system support 
personnel. 


Prerequisite Knowledge 


This publication assumes that you are familiar with the system from which you are 
converting. ; 


How to Use This Publication 


For those converting from VM/SP HPO Release 4.2 or 5: Read Part 1, “Converting 
from VM/SP HPO to VM/XA SP” on page 1. 


For those converting from VM/XA SF Release 2: Read Part 2, “Converting from 
VM/XA SF to VM/XA SP” on page 147. 


For those migrating from VM/XA SP Release 1: Read Part 3, “Migrating from 
VM/XA SP Release 1 to Release 2” on page 237. 


Note on the Scope of This Notebook 
The information in the notebook is designed for those interested in converting from 
VM/SP HPO or VM/XA SF, or migrating from VM/XA SP Release 1. You will 
find little information about exploiting the new and improved functions in VM/XA 
SP. IBM advises you to do your conversion or migration first, then exploit new 
functions on VM/XA SP as a second step. If you make improvements to your 
system while converting or migrating, this adds to the size of the project and 
hampers your ability to return to your previous system. While converting or 
migrating, make note of improvements you can make and return to them after you 
have completed the first step. In addition to making the scope of your job more 
manageable, converting or migrating first helps you set a clear criterion for the 
success of your conversion or migration; the same work you could do on your old 
system is what you can do on the new VM/XA SP system. 


You can find more information about exploiting the advanced functions of VM/XA 
SP in the VM/XA SP publications. 


Preface Ill 


If you are looking for more information about licensed programs or the hardware _ 
that VM/XA SP supports, see VM/XA SP General Information and the latest | fe | BN 
announcement materials. You can also get help from your IBM representative. ‘_/ 


Related Publications 
See the Bibliography at the back of this publication. 
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Part 1. Converting from VM/SP HPO to VM/XA SP_ 1 


VM/SP HPO Conversion 


Chapter 1. Overview: Systems Comparison 


This chapter compares the Virtual Machine/Extended Architecture™ System Product 
(VM/XA™ SP) to the Virtual Machine/System Product High Performance Option 
(VM/SP HPO) by providing: 


e A table summarizing compatibility 
e Greater detail for key items in the table. 


Summary of Compatibility between VM/SP HPO and VM/XA SP 


IBM designed VM/XA SP to satisfy the growth needs of large VM systems and to 
offer an attractive growth path for VM/SP HPO customers. In general, VM/XA SP 
provides more addressing capability and processing power than VM/SP HPO. 


While one of the primary objectives of VM/XA SP is to ease conversions by 
providing maximum compatibility with VM/SP HPO, factors such as architectural 
differences prevent full compatibility. IBM has made every effort to ease the 
conversion from VM/SP HPO by keeping, where possible, command syntax, 
responses, and message texts the same. 


IBM designed the CP differences to minimize their effect on the end user and on 
application programs. Differences in CP functions between VM/XA SP and VM/SP 
HPO are in the areas of architecture, systems design, and enhancements to the 
VM/XA SP system. In addition to functional differences, CP commands, 
DIAGNOSE codes, and messages may also differ. 


The CMS component in VM/XA SP is generally upwardly compatible with the CMS 
component in VM/SP HPO Release 5. If you are converting from VM/SP HPO 
Release 4.2, you must evaluate changes to CMS between VM/SP Release 4 and 
Release 5. Refer to VM/SP Release 5 publications to make this evaluation. See 
VM/XA SP CMS Application Program Conversion Guide for information about 
converting your applications to the VM/XA SP CMS. 


Table 1 shows a summary of the compatibility between VM/SP HPO and VM/XA 
SP. In the table, “compatible” means the item has equivalent syntax, responses, and 
functions. “Upwardly compatible” means there are differences in syntax, responses, 
or functions, but invocations using previous syntax should continue to execute 
unchanged in application programs. 


Table 1 (Page 1 of 7). Summary of Compatibility between VM/SP HPO and VM/XA SP 
VM/SP HPO Item 


Virtual machines 


VM/XA SP’s Support of the Item | 


VM/XA SP supports System/370 and 370-XA mode virtual 
machines, whereas VM/SP HPO supports only System/370 virtual 


machines. 


Virtual Machine/Extended Architecture and VM/XA are trademarks of the International Business Machines 


Corporation. 
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Table 1 (Page 2 of 7). Summary of Compatibility between VM/SP HPO and VM/XA SP 


VM/SP HPO Item VM/XA SP’s Support of the Item | 


Virtual Processors 


Single-image mode 


Preferred machine assist 


CP control blocks 


Real storage size 


Virtual storage addressing 


| Expanded Storage 


Preferred virtual machine 


System/370 architecture System/370 mode virtual machines are compatible with System/370 
| architecture. 


In VM/XA SP, virtual machines can have up to 64 virtual 
processors, allowing you to test the multiprocessing configurations of 
guest operating systems. Note also that any virtual machine can 
control all but one of the real processors of the real machine as 
dedicated processors. Additional virtual processors run on the 
master processor. In contrast, VM/SP HPO allows up to two virtual 
processors for the preferred virtual machine only (one dedicated and 
one virtual that shares the other instruction processor). 


VM/XA SP runs on all 370-XA multiprocessors in singie-image 
mode regardless of the number of instruction processors (N-way 
support), whereas VM/SP HPO supports up to two real instruction | 
processors on a multiprocessor. For example, VM/SP HPO supports 
the 3090 Model 400 in partitioned processing mode only while 
VM/XA SP supports all four processors in single-image mode. 


In VM/SP HPO, the preferred machine assist microcode allows an 
MVS/SP preferred virtual machine to directly control separate 
channels dedicated to it, thus gaining a performance improvement. 
The start interpretive-execution assist, available on most supported 
processors, gives a similar benefit on VM/XA SP, but without the 
need to dedicate separate channels to the preferred virtual machine. 
This may make it simpler for you to configure a preferred virtual 
machine’s I/O. 


In VM/XA SP, CP control blocks can be anywhere in real storage. 
In VM/SP HPO, in which large numbers of CMS users or a 
preferred guest can cause storage below the 16Mb line to be at a 

| premium, system control blocks have to be kept in the first 16Mb of 
real storage. | 


VM/XA SP supports the architected real storage size of 370-XA, 2 
gigabytes. VM/SP HPO supports a maximum of 64Mb. 


VM/XA SP supports 24-bit or 31-bit virtual storage addressing, 
giving a range of 2Gb. The current virtual addressing range 
supported by CP is 999Mb, providing 62 times the addressing 
capability as with VM/SP HPO. VM/SP HPO supports 24-bit 
addressing only. 


VM/XA SP allows you to share Expanded Storage among CP and 
virtual machines. VM/SP HPO uses Expanded Storage for CP 
paging and swapping only. 


VM/XA SP allows up to six preferred guests (V=R and V=F; there 
can be only one V=R) whereas VM/SP HPO supports one (V=R). 
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Table | (Page 3 of 7). Summary of Compatibility between VM/SP HPO and VM/XA SP 


VM/SP HPO Item VM/XA SP’s Support of the Item 


I/O management VM/XA SP uses the 370-XA channel subsystem, which moves the 
management of I/O from the processor and operating system into the 
channels themselves. Devices are addressed by any available path 
and an I/O interrupt does not always have to return on the same 
path from which it was started. This gives you improved 
performance, reliability, availability, and serviceability characteristics 
over those available when using System/370 I/O. Refer to “How I/O 
Differs” on page 10 for more information. 


Real channel programs As in VM/SP HPO, programs running in System/370 V = V machines 
may build and execute real channel programs, and use DIAGNOSE 
code X'98' or GCS macros to do this. But in VM/XA SP, you 
must reserve the real storage for these channel programs by 
specifying the RIO370 parameter of the SYSSTORE macro during 
system definition. (This same requirement exists in VM/XA SP for 
370-XA V=V machines running in 24-bit addressing mode, but not 
for 370-XA V=V machines running in 31-bit addressing mode.) 


Device numbers VM/XA SP uses four-digit real and virtual device numbers, while 
VM/SP HPO uses four-digit real device addresses (VM/SP HPO is 
limited to channel X'1F' while VM/XA SP can support up to 
X'FF') and three-digit virtual device addresses. This difference does 
not affect command invocation, but does result in an incompatibility 
in command responses and messages, since some responses and 
messages carry four-digit device numbers. 


Swapping Block paging provides similar function. Refer to “How Block 
Paging Differs from Swapping” on page 15 


In VM/XA SP, you do not define saved segments in a systems name 
table (DMKSNT) at system initialization time. Rather, you define 

saved segments using CP commands. Refer to “How Saved Segment 
Support Differs” on page 17. 


Saved segment support 


The spool file format is different in VM/XA SP. Asa result, you 
must use the SPTAPE command (along with a cold start) or RSCS 
to migrate spool files from VM/SP HPO to VM/XA SP. This is 

discussed in “Spool Files” on page 21. 


Spool files 


VM/XA SP does not support migrating system files between VM/SP 
HPO and VM/XA SP. System files include the following: 


¢ Files created by the VM/SP HPO ACNT, CPTRAP, and 
MONITOR commands 

e VM/XA SP named saved systems, saved segments, image 
libraries, user class restructure (UCR) files, and system trace 
files. 

e Virtual machine dumps, CP abend dumps, and CP stand-alone 

dumps from either VM/SP HPO or VM/XA SP. 


Journaling VM/XA SP supports RACF, which provides similar function. Refer 
to “Replacement for Journaling” on page 22. 


Migrating system files 


Chapter 1. Overview: Systems Comparison § 


VM/SP HPO Conversion 


Table 1 (Page 4 of 7). Summary of Compatibility between VM/SP HPO and VM/XA SP 


VM/SP HPO Item 


| Networking facilities 


| User minidisks 


CMS commands 


CMS macros 


CMS external control blocks 


CP command privilege classes 


Message action indicators 


Nonzero return codes 


Leading zeros 


EXECs written in CMS EXEC, 
EXEC 2, or REXX 


Programs written in high-level 
languages 


Assembler application programs 


and any program using 24-bit 
addressing 


OS simulation services 


VM/XA SP’s Support of the Item 


As in VM/SP HPO, you can use the group control system (GCS) 
component of VM/XA SP to implement a native SNA 
communication network. There are several differences. Refer to 
“Networking Facilities” on page 23. 


CMS minidisks are fully compatible and those that reside on 
VM/XA SP-supported devices can be used unchanged. 


All VM/XA SP CMS commands are compatible except the DEBUG 
command. There are new CMS commands that invoke new function 
and there are enhanced commands to invoke enhanced function. 

The enhanced commands are upwardly compatible. 


CMS macros in VM/XA SP are upwardly compatible. 


CMS external control blocks in VM/XA SP are compatible. 
VM/XA SP CMS does not have the FREELOWE field in NUCON. 
Particularly sensitive to the conversion are programs that “steal 
PSWs” or field external interrupts. 


Privilege classes for some VM/XA SP CP commands and 
DIAGNOSE codes may differ for the corresponding CP commands 
in VM/SP HPO. 


Action indicators (for example, the “E” in message 204E) on 
VM/XA SP CP messages may differ for the corresponding messages 
in VM/SP HPO, even though the message number may be the same. 


The nonzero return code and accompanying message that VM/XA 
SP returns for errors may not be the same as the nonzero return 
code that VM/SP HPO returns for corresponding errors. 


VM/XA SP suppresses leading zeros more often than VM/SP HPO 
does. 


Generally, these EXECs are upwardly compatible. However, EXECs 
that use CP commands or DIAGNOSE codes must be examined for 
compatibility. You should also check return codes or CP responses. 
EXEC, EXEC 2, and REXX programs run in System/370 mode or 
370-XA mode virtual machines but only below the 16Mb line. 


Programs written in the high-level languages (not the EXEC 
languages) that VM/XA SP supports are source and object code 
compatible. 


They should execute without change. Exceptions could be programs 
that: 


e Depend on internal CP or CMS structure or control blocks 
¢ Depend on functions that CP does not provide 

* Depend on incompatible CP externals 

¢ Depend on explicit System/370 architecture implementation. 


Refer to Chapter 8, “Application Programming” on page 91 for 
more details. 


OS simulation is compatible with VM/SP Release 5 CMS. VM/XA 
SP adds MVS/XA macros. | 
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| Table 1 (Page 5 of 7). Summary of Compatibility between VM/SP HPO and VM/XA SP 


VM/SP HPO Item VM/XA SP’s Support of the Item | 
DOS/VSE simulation DOS/VSE simulation is compatible with VM/SP Release 5 CMS. 


Installing CP Installation procedures for the VM/XA SP CP are generally 
compatible with VM/SP HPO. There are differences for the system 
definition (SYS) file, the real I/O (RIO) file, and the user directory. 
The system name table (SNT) does not exist in VM/XA SP. You 
generate saved segments while the system is operating, so you do not 
need to convert saved segments during the installation procedure. 
Refer to Chapter 3, “Installation and Service” on page 45 for a 
detailed discussion. 


Installing CMS on VM/XA SP 1s a similar, EXEC-driven procedure. 
CMS as a named saved system requires 2Mb of virtual storage. 


Installing GCS on VM/XA SP is a similar, EXEC-driven procedure. 


Installing CMS | 


Installing GCS 


Installing user-written 
applications and licensed 
programs in shared storage 


Installing user-written applications and licensed programs in shared 
storage differs due to the improved usability of VM/XA SP’s shared 
| storage support. You have to rebuild named saved systems and 
saved segments into 1Mb segments (you can store more than one 
licensed program in this 1Mb segment) and remap saved segment 
storage layouts. This is a one-time effort. Refer to “How Saved 
Segment Support Differs” on page 17, “Managing Saved Segments” 
on page 61, and VM/XA SP Planning and Administration. 


Licensed programs You can find a list of supported licensed programs in VM/XA SP 


General Information. 


Devices You can find a list of supported devices in VM/XA SP General 


Information. 


VM/RTM, VMMAP, and VM/XA SP supports a real time monitor called RTM/SF. Its output 
VMPPF looks similar to VM/RTM’s in VM/SP HPO but has different 
meaning due to architectural differences in the two systems. 


VM/XA SP does not support a monitor analysis program or a 

performance predictor facility. VM/XA SP does provide monitor 
data and a sample program called MONWRITE, which writes the 
raw monitor data to disk or tape. 


: 


CP monitor The VM/XA SP monitor collects data in categories called domains 
rather than in categories called classes, samples, and events. The 


monitor writes records to saved segments, not to spool files. Refer 
to “The VM/XA SP Monitor” on page 75. 


EREP Files created by the CPEREPXA command are stored in CMS files. 
You must set up a virtual machine to collect these files. 
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Table | (Page 6 of 7). Summary of Compatibility between VM/SP HPO and VM/XA SP 


VM/SP HPO Item | VM/XA SP’s Support of the Item 


Stand-alone utilities | VM/XA SP supports a stand-alone dump utility program, the Device 
| Support Facilities program, and two versions of the DASD dump 
| restore program 


® QOne version, DDRXA, is a stand-alone program that can be run 
either on a real 370-XA processor or in a 370-XA virtual 
machine. 
The other version, the System/370 DDR program, is a CMS 
facility that can be run only under CMS in a System/370 virtual 
machine. 


VM/XA SP does not support a stand-alone nes program or 
Format/Allocate program. 


Checkpoint start Checkpoint start is not required because of the VM/XA SP spooling: 
design. 
IPCS VM/XA SP provides the dump viewing facility instead of IPCS. 


There are differences in the naming of dumps, in symptom record 
handling for non-CP dumps, in processing trace table data, and in 
display management capability. Also, the dump viewing facility does 
not support the problem recording and management functions of 
IPCS. 


IUCV IUCV in VM/XA SP is compatible with IUCV in VM/SP HPO 
except that VM/XA SP does not support the following CP system 
services: *CRM, *IDENT, *LOGREC, and *SPL. VM/XA SP 
adds a new CP system service, *MONITOR. 


FBA devices | VM/XA SP supports the 3370 as dedicated-only. 


Nondisruptive transition Nondisruptive transition is no longer needed because of the way 
VM/XA SP handles the V=R machine. 


Single processor mode Single processor mode is no longer needed because of virtual 


machine multiprocessing. 


VM/XA SP supports all VM/SP HPO-supported operating systems 
as guests except for [IX/370 and MUSIC/SP. VM/XA SP adds 
MVS/XA, TPF, VM/XA SF, and VM/XA SP. 


VM/XA SP and VM/SP HPO CPs have significantly different 
internal structures. You have to rework VM/SP HPO CP user 
modifications in order to apply them to the VM/XA SP CP. IBM 
provides a sample exec, called COMPSCAN SAMPEXEC, to help 
you convert applications. Refer to Appendix A, “Conversion 
Tools” on page 277. | 


Guest operating systems 


User modifications to the system 


ASCII terminals VM/XA SP supports fie connection of ASCII terminals through 
VTAM or an IBM 7171 Device Attachment Control Unit. VM/SP 
HPO supports the connection of ASCII terminals through VTAM, 


through an IBM 7171 Device Attachment Control Unit, or natively. 


Advanced printing subsystem VM/XA SP will support APSS after general availability of VM/XA 
services (APSS) | SP Release 2. 


Product documentation The VM/XA SP documentation is structured by task. As a result, 
| the VM/XA SP and VM/SP HPO CP manuals differ in structure. 
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Table 1 (Page 7 of 7). Summary of Compatibility between VM/SP HPO and VM/XA SP | 
VM/SP HPO Item VM/XA SP’s Support of the Item 


Alternate CP nucleus VM/XA SP does not support these VM/SP HPO functions. 
support 

Indexed sequential access 

method (ISAM) 

Line mode devices 

Native CP communication 


line driver support 

Page migration 
Preallocated dump space 
SHUTDOWN re-IPL 


Transparent services access 
facility (TSAF) 


| New Functions That Do Not Affect Conversion 

| Some of the explanations in Table 1 describe new functions in VM/XA SP. Listed 
| below are additional new functions. To exploit these functions, be sure to read the 
| other publications in the VM/XA SP library. These new functions include: 


| ¢ Multiple preferred guests, provided you have the Processor Resource/Systems 
| Manager™ (PR/SM™) feature on your 3090 Model E processor 


= | e Expanded Storage caching capability for virtual machine logon, IPL, and CMS 
( system minidisks 


| e Ability to dedicate Expanded Storage to a guest 


e Ability to attach logical devices 

| ¢ Logged-on user limit changes 

| e Additional soft abend dump capability 

| ¢ Automatic load balancing across paging devices 


( _ | «© New DIAGNOSE codes (see “VM/XA SP-Only DIAGNOSE Codes” on 
| page 127) 


| e New commands or operands, which provide the ability to: 


| — Retain spool files in hold status after processing (the KEEP operand of the 
| CHANGE command) 


| — Display the contents of third-level storage (the DISPLAY command) 


| — Prevent specific users from logging on to the system (the HOLD LOGON 
| command) 


| — Specify more at logon (the LOGON command), such as your virtual 
| machine storage size (the STORAGE operand) and an account number (the 
| ACCOUNT operand) | 


| Processor Resource/Systems Manager and PR/SM are trademarks of the International Business Machines 
| Corporation. 
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— Display the number of allocated, in use, and available cylinders for DASD 


volumes attached to the system (the QUERY ALLOC command) a 
— Display the spool file limit for the system or for any individual user (the 


QUERY MAXSPOOL command) 


— Display and set the current limit of logged-on users (the QUERY 
MAXUSERS and SET MAXUSERS commands) 


— Specify whether CP or your virtual machine will handle the SVC76 
instruction (the SET SVC76 command) 


— Make a path to devices logically available or unavailable for use by the 
system (the VARY PATH command). 


How I/O Differs 


One of the major differences between System/370 and 370-XA architecture is in the 

way I/O is handled. Each architecture has a unique instruction set and a unique Ye 
method of handling I/O to and from devices. 370-XA replaces System/370 channels | 
with a channel subsystem. 


The main differences are: 


e The 370-XA channel subsystem is designed so all processors in the system can 
access all the devices attached to the system. 


¢ In 370-XA, hardware, rather than software, handles path management. 


® 370-XA device numbers do not have to correspond to the physical attachment of 


the I/O device. (For back off purposes, you should make the VM/XA SP device -_ 
numbers correspond to the VM/SP HPO addresses.) Ms? 
In System/370, you relate devices to control units or channels. For instance, I/O 
set up for device number 342 would be as shown in Figure 1. 
Channel Control unit 
2 | 4 
Figure 1. System/370 Rationale for Device Numbers See 


In 370-XA, you relate devices to subchannels. Since each subchannel is uniquely 
associated with one I/O device and that I/O device is uniquely associated with 
that one subchannel, the subchannel becomes the addressable unit. 


The VM/XA SP channel subsystem is more efficient than the System/370 channels, 
because it moves I/O management functions out of the control program and into the 


hardware. This makes your job easier since you no longer need to define all the 
paths to a device in HCPRIO (the VM/XA SP equivalent of DMKRIO). 


Figure 2 on page 11 and Figure 3 on page 12 provide a conceptual overview of the 
differences. 
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Figure 2. System/370 I/O Structure 
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Channel subsystem 


Creating an [OCD 


£ 
ae SE fg 
Devices 
| CPU 
| Main 
storage 
CPU Pa: fey ie ‘ 


Subchannels 


Figure 3. 370-XA I/O Structure 


S 

If you are running VM/SP HPO on a 308X or 3090, you must have defined the real 
I/O configuration to the hardware. Using the Input/Output Configuration Program 
(IOCP), you would have created an input/output configuration data set IOCDS). i 
VM/XA SP requires an IOCDS for 308X, 3090, and 4381 processors. : 


You can use the same IOCDS for VM/XA SP that you use for VM/SP HPO— unless 
you defined your I/O in an unconventional manner in VM/SP HPO. For instance, if 
you used expedient means in VM/SP HPO, such as assigning two addresses to the 
same device or defining each path to a control unit as a separate control unit (so you 
could share dedicated devices or attach a single tape unit to several virtual machine 
guests), you will have to create a new IOCDS. In VM/XA SP, the same expedient 
means may cause the system to hang or data integrity to be lost. 


Even if your current IOCDS does not have these problems, you may benefit from 
reconfiguring your I/O. During the migration period, however, it is important to 
have an IOCDS that can be used in both System/370 and 370-XA modes. 
Therefore, you might consider reconfiguring your I/O in a manner that can be used 
for both the VM/SP HPO and VM/XA SP systems. 
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Recommendations for Configuring the I/O 
You may want to consider the following: 


When configuring the I/O for the VM/XA SP system, ensure that the I/O 
configuration described in HCPRIO (the VM/XA SP equivalent of DMKRIO) 
matches that described in the IOCDS. At system initialization, CP sends 
warning messages to the primary system operator about devices it finds offline. 
CP does this by checking the hardware I/O configuration defined by HCPRIO 
ASSEMBLE. If you have assured that HCPRIO ASSEMBLE and the IOCDS 
are compatible, the primary system operator receives warning messages only for 
devices that are intended to be online but were inadvertently left offline. 


To make it easier to convert between your VM/SP HPO system and your 
VM/XA SP system, you should assign the same device numbers in your VM/XA 
SP system that you use in your VM/SP HPO system. 


In VM/XA SP, each subchannel is uniquely associated with one I/O device and 
that I/O device is uniquely associated with that one subchannel, regardless of the 
number of channel paths by which the I/O device is accessible. 


When running a System/370 operating system as a guest on VM/XA SP, you do 
not need to define alternate channels and alternate control units. 


System/370 Example of IOCP and DMKRIO Files 


Figure 4 is an example of a System/370 I/O configuration. 


Channel CHPID 


4 
4 


Channel 
set 0 

CPU | 

Main 
storage | 
CPU | 
: 

Channel 
set 1 


Figure 4. Example of a System/370 [/O Configuration 


IOCP and DMKRIO files that define the configuration in Figure 4 follow. 


VM/SP HPO IOCP file: 


CHPID PATH=((04,4,0)) , TYPE=BL 

CHPID PATH=((05,5,0)) , TYPE=BL 

CHPID PATH=((20,4,1)),TYPE=BL 

CHPID PATH=((21,5,1)),TYPE=BL 

CNTLUNIT CUNUMBR=042,PATH=(04,20) , SHARED=N ,UNIT=3880, 
PROTOCL=S , UNITADD=((20,32)) 

CNTLUNIT CUNUMBR=052, PATH=(05,21) , SHARED=N , UNIT=3880, 
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PROTOCL=S , UNITADD=( (20, 32) ) 
IODEVICE ADDRESS=(420,32) , CUNUMBR=(042,052) ,UNIT=3380 
VM/SP HPO DMKRIO file: 


RDEVICE ADDRESS=(420,32) ,DEVTYPE=3380, ALTCU=520 
RCTLUNIT ADDRESS=420, CUTYPE=3880 
RCTLUNIT ADDRESS=520, CUTYPE=3880 
RCHANNEL ADDRESS=4, CHTYPE=BLKMPXR 
RCHANNEL ADDRESS=5,CHTYPE=BLKMPXR 
In the VM/SP HPO IOCP and DMKRIO files you can see that: 
¢ Each channel must be assigned to a specific processor. 


¢ Each piece of hardware must have its own definition. 


e There can be multiple paths to a DASD through multiple address ranges. In 
this example, there are four paths to one DASD through two address ranges. 


370-XA Example of IOCP and HCPRIO Files 


A corresponding 370-XA I/O configuration would look as shown in Figure 5. 


Channel subsystem 


| 
4 
r 
eas 
|| 21 


Figure 5. Example of a 370-XA I/O Configuration 


Corresponding 370-XA IOCP and HCPRIO files would look as follows. 
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VM/XA SP IOCP file: 


CHPID PATH=((04)), TYPE=BL 

CHPID PATH=((05)), TYPE=BL 

CHPID PATH=( (20) ) , TYPE=BL 

CHPID PATH=((21)) , TYPE=BL 

CNTLUNIT CUNUMBR=042 ,PATH=(04,20) ,SHARED=N,UNIT=3880, 
PROTOCL=S , UNITADD=( (20,32) ) 

CNTLUNIT CUNUMBR=052,PATH=(05,21) , SHARED=N,UNIT=3880, 
PROTOCL=S , UNITADD=( (20,32) ) 

IODEVICE ADDRESS=(420,32) , CUNUMBR=(042,052) , UNIT=3380 


VM/XA SP HCPRIO file: 
RDEVICE DEVNO=(420,32) ,DEVTYPE=3380 


In the VM/XA SP IOCP and HCPRIO files you can see that: 
¢ Each channel can be accessed by any processor. 
e There can be a ‘logical’ control unit made up of two real control units. 


¢ There can be multiple paths to a DASD through a single address range. In this 
example, there are four paths to one DASD through only one address range. 


Vary Channel Path Support 


VM/XA SP provides commands to vary channel paths online and offline logically. 
The VARY PATH command allows the system operator to logically make a path to 
one or more devices available or unavailable for system use. Without this support, 
you would have to reload (IPL) the entire VM system or vary all devices offline, 
then online, just to gain the one or more paths desired. The vary channel path 
support allows you to isolate control units for maintenance or dynamically add a 
new channel path without disrupting the entire system’s I/O configuration. 


This support also includes commands that allow the system operator to obtain path 
allocation information. The QUERY PATHS command displays the logical online 
or offline status of all paths leading to a specified device. The QUERY CHPID 
command allows the operator to find all the devices accessible through a specified 
channel path and the logical online and offline status of each device on that path. 


How Block Paging Differs from Swapping 


VM/XA SP’s block paging capability was designed to meet the same objectives as 
VM/SP HPO’s swapping function. (Do not confuse the block paging capability with 
the function of Expanded Storage.) Like swapping, block paging retrieves groups of 
pages rather than a single page at a time. This reduces page read overhead, 
recognizes user working sets, reduces the page fault rate, and utilizes DASD 
technology. 


However, the design of block paging differs from that of swapping. Table 2 on 
page 16 compares VM/SP HPO’s swapping with VM/XA SP’s block paging. 
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Table 2 (Page 1 of 2). How Block Paging Differs from Swapping 


VM/SP HPO Swapping | VM/XA SP Block Paging | 


You define an amount of space to be 
used for paging and a separate 
amount of space to be used for 


swapping. You split the paging space — 


between primary paging, general 
paging, and page migration. 


You can define a fixed value for the 
swap sets (such as 9) on the SYSPAG 
macro in DMKSYS. 


You can specify a prepage value (such 
as 2 swap sets) using the SET SRM 
PREPAGE command. This means 
that the specified number of pages are 
brought in before the virtual machine 
executes. 


CP forms swap sets without regard to 
virtual addresses. 


CP switches DASD volumes after 
every swap set. 


When CP reads a page from the 
paging area, it does not destroy the 

| data. Thus, CP only needs to rewrite 

the page if it is changed. 


When CP reads swap sets from the 
swap area, it destroys the data after 
reading it. Thus, CP needs to rewrite 
all pages in the swap set, regardless of 
whether they are changed. 


CP includes in a swap set all pages 
referenced by the user within a time 
interval, whether or not the user 
changed the page. Similarly, CP 
removes pages from the swap set when 
they are unreferenced by the user, not 
when they are unchanged. 


After using a swap set, CP writes the 
unreferenced pages out to the paging 
area and writes the referenced pages in 
swap sets out to the swapping area. 


16 VM/XA System Product Conversion Notebook 


There is no distinction between paging 
and block paging space. You define a 
single amount of space; CP uses the 
space for both single pages and blocks 
of pages. There is no distinction 
between primary and general paging. 
Also, there is no page migration. 


You do not define the size of blocks. 


There is no prepage function; block 
paging is performed on demand only. 


CP forms blocks only within the same 
1Mb segment of the virtual machine. 


_ CP switches DASD volumes after 


allocating twice the number of records 
that can fit on a track. 


When CP reads a single page or a 
block of pages, it destroys the data 
after reading it. Thus, CP needs to 
rewrite all pages (both single pages 
and blocks of pages), regardless of 
whether they are changed. 


This works the same way in VM/XA 
SP as in VM/SP HPO. CP includes in 
a block of pages all pages referenced 
by the user within a time interval, 
whether or not the user changed the 
page. Similarly, CP removes pages 
from the block when they are 
unreferenced by the user, not when 
they are unchanged. 


Since there is only one area for both 
paging and block paging, CP writes 
both referenced and unreferenced 
pages to the same area. 
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Table 2 (Page 2 of 2). How Block Paging Differs from Swapping 


VM/SP HPO Swapping VM/XA SP Block Paging 


The cursor moves from the beginning The cursor moves through the paging 


to the end of the swapping area. area but does not necessarily move all 
When it reaches the end, it returns to the way to the end. When the space 
the beginning and starts over. Asa behind the cursor is 75% empty, the 
result, seek time increases as the size cursor returns to the beginning. This 
of the swap area increases. This means that you don’t have to worry 
means that you must be careful not to about allocating too much paging 
allocate more swap space than you space. CP uses only the amount that 


need. it needs. 


Refer to “Guidelines for Converting Your VM/SP HPO Paging and Swapping” on 
page 75 for administrative suggestions. 


How Saved Segment Support Differs 


Although the basic concept is the same, the saved segment support in VM/XA SP 
differs from the saved segment support in VM/SP HPO. Table 3 summarizes the 
differences. 


Table 3 (Page 1 of 2). How Saved Segment Support Differs 


VM/SP HPO Saved Segment Support 


You define saved segments during 
system initialization using a system 
names table (DMKSNT). 


Storage 1s comprised of 64K segments, 
each containing 16 pages of 4K 
storage. 


You can store only one licensed 
program in each 64K segment. The 
licensed program must be stored on a 
64K boundary. 


You define the ranges of licensed 
programs in decimal values. Messages 
and responses are in decimal. 


VM/XA SP Saved Segment Support 


You define saved segments while the 
system is running using CP 
commands. This is discussed in 
“Managing Saved Segments” on 
page 6l. 


Storage 1s comprised of 1Mb 
segments, each containing 256 pages 
of 4K storage. 


You can store several licensed 
programs in one or more 1Mb 
segments as long as you do not store 
both shared code and nonshared 
(exclusive) code in the same 1Mb 
segment. Each licensed program must 
be stored on a page boundary. This is 
discussed in “Storing Multiple 
Licensed Programs in One Segment” 
on page 18. 


You define the ranges of licensed 
programs in hexadecimal values. 
Messages and responses are in 
hexadecimal. 
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Table 3 (Page 2 of 2). How Saved Segment Support Differs 


VM/SP HPO Saved Segment Support © VM/XA SP Saved Segment Support 


CMS can use a program in a saved CMS can use a program in a saved 
segment only when the segment is segment whether the segment is inside 
outside its address space. This is why or outside its address space. If the 
the saved segments are called saved segment is inside the address 
discontiguous. space, it is not considered 
discontiguous. 


Because of the major differences between VM/SP HPO and VM/XA SP in this area, 
you must completely remap your installation’s shared storage. You cannot simply 
convert your DMKSNT to be used in VM/XA. This remapping is a one-time effort. 


When converting to VM/XA SP, you should maintain the DMKSNT file on the 
VM/SP HPO SYSRES in case you need to back off to VM/SP HPO. The VM/XA 
SP saved segments and saved systems are kept in system data files and cannot be 
transferred to VM/SP HPO using SPTAPE. (You can move files between VM/XA 
SP systems using SPTAPE.) 


Storing Multiple Licensed Programs in One Segment 
As in VM/SP HPO, you can define a saved segment into which you can store one 
licensed program. In VM/SP HPO, the discontiguous saved segment (DCSS) is on a 
64K boundary; in VM/XA SP, the saved segment is on a megabyte boundary. 


But, to provide more efficient use of storage, VM/XA SP also allows you to define 
segment spaces into which you can store multiple licensed programs. In this case, the 
segment space is on a megabyte boundary but each licensed program is stored on a 
page boundary. Thus, you can store many more programs in a given area without 
wasting storage. This is particularly important to you when running application 
programs in 370-compatibility mode because you need to fit all your licensed 
programs below the 16Mb line. Once you exploit VM/XA SP and can address 
licensed programs above the 16Mb line, you do not need to store licensed programs 
so tightly; 1Mb segments will be sufficient. 


You can mix shared and nonshared code within the same segment space as long as 
you do not mix them within the same 1Mb segment. So, if you have a licensed 
program, such as PROFS, which requires both shared and exclusive code, you can 
store both parts in the segment space but you must store them in separate 1Mb 
segments. 


Figure 6 on page 19 shows ISPF/PDF, ISPF, and PROFS all stored in one segment 
space which spans three 1Mb segments (from the beginning of megabyte 1 to the end 
of megabyte 3). In this case, ISPF/PDF, ISPF, and PROFS are all considered 
member saved segments of this segment space. Note that the boundaries of the 
segment space are rounded to megabyte boundaries. 
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SPACE1 


PROFS (exclusive) 


3 Mb — 
PROFS (shared) 
ISPF (shared) 
2 Mb — 
ISPF/PDF (shared) 
1 Mb -— 
( - Figure 6. Using a Segment Space to Store Licensed Programs 


Overlaying Licensed Programs 
As in VM/SP HPO, you can overlay saved segments (that is, define multiple saved 
segments at the same address range) to make more efficient use of virtual storage. 


You can also overlay segment spaces. When you do this, the second segment space 
replaces the entire address range of the first segment space, even if it is not defined 
on. at exactly the same location as the first segment space. If a segment space overlays 

( part of another segment space, it causes all of the currently loaded space to be 
removed from the user’s address space. For example, look at the storage layout in 
Figure 7 on page 20. If you load SPACE3 while SPACE? is loaded, all of SPACE2 
is removed from the guest’s address space even though only part of SPACE2 is 
overlapped. Similarly, if you load SPACE4 while SPACE2 is loaded, all of SPACE2 
is removed from the user’s address space. Refer to “Managing Saved Segments” on 
page 61 for a discussion of how to manage saved segments in VM/XA SP. 
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SPACE2 
7 Mb — 
6 Mb - VMAS (shared) 
SQL/DS (shared) 
5 Mb — 
4 Mb — 


8 Mb — 

QMF (shared) 
ais SPACE4 
6 Mb 

FORTRAN (shared) 
5 Mb -| Gppm (shared) SPACE3 
4 Mb — 


Figure 7. Using Segment Spaces to Overlay Licensed Programs 


Saved Segment Terminology 


Table 4 explains terminology used to describe attributes of saved segments. 


Table 4 (Page 1 of 2). Saved Segment Terminology 


DCSS 


Contains one or more 
megabytes of storage 


Beginning address is 
rounded down to the 
nearest megabyte 
boundary 


Ending address is 
rounded up to the 
nearest megabyte 

boundary. 


Minimum size is 1Mb, 
regardless of how many 
pages are defined; 
maximum is 999Mb 


May span megabyte 
boundaries 


May be saved by name 
with the SAVESEG 
command 
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Segment Space 


Contains one or more 
megabytes of storage 


Beginning address is 
rounded down to the 
nearest megabyte 
boundary 


Ending address is 
rounded up to the 
nearest megabyte 

boundary 


Minimum size is 1Mb, 
regardless of how many 
pages are defined; 
maximum 1s 999Mb 


May span megabyte 
boundaries 


May not be saved by 
name 


Member Saved Segment 


Contains one or more 
megabytes of storage 


Beginning address is a 
page boundary 


Ending address is 
rounded up to the last 
byte in its last page 


Minimum size is 4K, 
maximum is 999Mb 


May span megabyte 
boundaries 


May be saved by name 
with the SAVESEG 
command 
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Table 4 (Page 2 of 2). Saved Segment Terminology 
Segment Space Member Saved Segment 


May be loaded! by May be loaded! by May be loaded! by 
name with DIAGNOSE name with DIAGNOSE name with DIAGNOSE 
X'64' xX'64' X'64' 


May be purged! by May be purged! by May be purged! by 
name name name 


Contains a single shared Contains up to 64 Is associated with up to 
item member saved segments 64 segment spaces 


Use of System Data Files 
VM/XA SP stores saved segments in system data files. 


A system data file is a special type of spool file that resides in system spool space 
and contains a collection of data associated with a particular system function. You 
can create, purge, or replace system data files dynamically without regenerating the 
operating system, thus maintaining system availability while doing routine 
management. If you need to do a cold start of the system, the system data files 
survive. 


VM/XA SP uses system data files for: 
e Saved segments and named saved systems 
e Image libraries for all printers 
e CP command privilege class override data 


e System trace files. 


Spool Files 


Because of the incompatibilities in spool file formats between VM/SP HPO and 
VM/XA SP, you must perform a cold start when converting to VM/XA SP or 
backing off from VM/XA SP. Use RSCS or the SPTAPE command to transport the 
spool files back and forth. 


If you bring up a VM/SP HPO guest on VM/XA SP and have RSCS service 


machines running on VM/SP HPO and VM/XA SP, you can use RSCS to send the 
VM/SP HPO spool files to the VM/XA SP system. 


If you do not bring up a VM/SP HPO guest, you must use the SPTAPE command 


to migrate spool files from VM/SP HPO to VM/XA SP. This is discussed in detail 
in “Migrating Spool Files” on page 54. 


| 1! Loading and purging may instead be done with the CMS SEGMENT command or SEGMENT macro. 
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Spool File Limit 


VM/SP HPO Release 4.2 allows up to 9900 spool files per system while VM/SP 
HPO Release 5 allows up to 9900 spool files per user. VM/XA SP allows up to 9999 
spool files per user. 


In VM/SP HPO Release 5, you control the total number of spool files in the system 
using the SYSSPL parameter on the SYSRES macro and the size of the checkpoint 
area. In VM/XA SP, there is no parameter for limiting the number of spool files in 
the system. The total number of files allowed in the system is determined by the size 
of the warm start area. 


Although VM/XA SP does not provide a parameter for limiting the number of spool 
files in the system, it does provide a parameter for limiting the number of spool files 
for individual users. You do this using the MAXSPOOL parameter on the 
SPOOLFILE directory control statement. 


Determining the Amount of Spool Space Needed 


Each DASD type can hold a specific number of pages per cylinder. For instance, a 
3380 holds 150 pages per cylinder, allowing nearly 154,000 files. See VM/XA SP 
Installation and Service for the number of pages you can fit on a cylinder of a 
specific DASD type. 


The total spooling space you need depends on the type of spool files you typically 
have. Small files such as PROFS notes typically use about two pages of DASD 
storage. Large files like listings, documents, and dumps require much more. Since 
trailing blanks are suppressed, “narrow” files of many lines require less space than 
“wide” files with right-hand margins, such as listings. Printer fonts are large and 
may consume space in environments that process sophisticated documents. A typical 
installation needs to allocate about 500 cylinders for spool space. See VM/XA SP 
Planning and Administration for details. 


Your system operator will receive a warning message when spooling space is nearly 
full. The operator can bring additional spooling volumes online if those volumes are 
defined on the SYSCPVOL macro. Otherwise, your operator should request that 
spool files be purged, processed, or put on tape with the SPTAPE command. 


if You Are Converting from VM/SP HPO Release 4.2 


If you are converting from VM/SP HPO Release 4.2, do not exceed 9999 spool files 
in the VM/XA SP system until you are sure that you will not need to back off to 
VM/SP HPO. Otherwise, you will not be able to migrate all of the spool files back 
to VM/SP HPO. 7 


Replacement for Journaling 


Since VM/XA SP does not support journaling, you may want to install the Resource 
Access Control Facility (RACF) Version 1 Release 8 to provide this on your system. 
If you do install RACF, take note of the following: 


¢ You can operate RACF in defer mode. This means that although RACF does 
authority checks, it issues only warning messages. Access to the resource is 
granted based on regular VM/XA SP access checks. Defer mode eases your 
conversion during the period immediately after you install RACF. 


After you have completed your conversion to RACF, you can operate RACF in 
full fail mode, which denies access to a resource when the RACF authority 
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check fails. If a RACF authority check succeeds, a command completes 
oo execution with no change. If the RACF authority check fails, the command 
( | terminates with a message. 


e End users are affected by RACF. RACF does not immediately lock a user out 
of the system when the password expires. For instance, if a user’s password 1s 
expired, RACF allows the user to change the password during logon. (Previous 
releases of RACF allowed a user to change the password whether or not it was 
expired. RACF 1.8 allows a user to change the password at logon only if it is 
expired.) 


RACF can be shared among multiple systems, whether they are first-level or 
second-level. 


_ Networking Facilities 


pes | As in VM/SP HPO, you can use the group control system (GCS) component of 
( | VM/XA SP to implement a native SNA communication network. Differences are: 


| e VM/XA SP does not support the transparent services access facility (TSAF) and 
| therefore does not support the Advanced Program-to-Program 
| Communication/VM (APPC/VM) protocol. 


| ~¢@ In VM/SP HPO, a virtual machine gains access to the GCS supervisor by a link 
| (the LINK command or LINK directory control statement) to the GCS system 
| disk. In VM/XA SP, this access is controlled by the RSTD operand of the 

| DEFSYS command (to define the GCS named saved system as restricted) and 

| by the NAMESAVE directory control statement (placed in the directories of 

| virtual machines that are allowed to access the GCS named saved system). 


| ¢ In VM/SP HPO, you use the DMKSNT file to define the name and location of 
| VTAM saved segments. In VM/XA SP, you use the DEFSYS (for GCS) and 

| DEFSEG (for VTAM) commands to define skeleton files that provide similar 

| functions. You then load these files with GCS and VTAM as named saved 

| systems. 


| Several customers report using the same parameter values for DEFSYS as for 
| DMKSNT. 


| ¢ To execute real I/O, which moves data between main storage and real I/O 

| devices, VTAM must build a channel program in real storage. In VM/XA SP, 
| VTAM does this by locking pages of virtual storage into real storage, requiring 
| you to: 


| — Specify how much real storage to lock by using the RIO370 parameter of 

| the SYSSTORE macro in HCPSYS, the system control file. RIO370 

| specifies the number of 4K page frames used by a System/370 V=V machine 
| (like VTAM) or a 370-XA V=V machine operating in 24-bit addressing 

| mode that executes real channel programs. 


| — Authorize the VTAM service machine to execute real channel programs by 
| specifying the DIAG98 option of the OPTION directory statement in the 
| VTAM service machine’s directory. 


| You can determine the RIO370 parameter value from calculations described in 
| Network Program Products Storage Estimates. In the table for constant 

| common storage requirements, complete the calculations for major node 
| 
| 


activated (channel-attached communication controllers and channel-attached 
devices). The total of these calculations (with the exception of the calculation 
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for NetView™ PIU trace activity), rounded up to a 4K multiple, is your RIO370 

value for VTAM. If you have other V=V 24-bit machines that execute real Pant 
channel programs in addition to VTAM, you must add their values to the — ; 
VTAM value. If you set the RIO370 value too low, VTAM can fail. Several XT 
customers with VTAM and two channel-to-channel adapters report using values 
between 120 and 200. | 


You can use the QUERY FRAMES command to display the status of the 
RIO370 area. 


How System Scheduling, Tuning, and Monitoring Differ 


Refer to “Managing System Performance” on page 70 for a discussion of the 
VM/XA SP scheduler, tuning controls, and the VM/XA SP monitor. 


| NetView is a trademark of the International Business Machines Corporation. 
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Chapter 2. Planning for Conversion 


Developing a Conversion Plan 


A conversion plan 1s the key to a successful conversion to VM/XA SP. Planning 
should begin early, ideally as soon as you make the decision to order VM/XA SP. 
To begin your plan, take inventory of your current system hardware and software, 
and then establish goals for what your new system environment will contain. 


Planning for the conversion 1s the process of organizing the conversion project in 
such a way as to produce a new system that meets requirements set by your 
installation. 


Key points you have to consider for conversion planning are: 


1. Develop a statement of purpose for your system conversion. 


The goals for conversion set boundaries on the conversion process and help you 
put a plan in place that meets your requirements. 


2. Understand the conversion requirements. 


These include: 


Technical requirements. What is the technical goal for the new system? For 
example, your goal might be to remove storage constraints for applications. 


Schedule. When do you expect the conversion to be complete? A 
conversion takes considerably longer than a release-to-release migration. 


Human resources. How many people do you need to perform the 
conversion? It is best to have one person coordinate the conversion. The 
number of other people involved varies from installation to installation and 
is based on the complexity of the system, the experience of the personnel, 
the number of applications, and many other factors. Remember to have 
backups for key people. 


Cost. What is the acceptable limit to the conversion expense? 


Workload. What is the maximum workload given current resources? Are 
additional resources needed? 


3. Establish or update your system technical inventory. 


You should begin your conversion with an accurate inventory of all the elements 
of your system. Make a list of: 


Hardware configuration. This should reflect what is already installed plus 
any hardware you plan to install or remove during the conversion time 
period. 


Software products. All installed licensed programs, both IBM and vendor 
products, that are used on your current system. 


Applications. You should make an inventory of all applications on your 
VM/SP HPO system, especially those that use CP and CMS interfaces such 
as CP commands, DIAGNOSE codes, messages, CP macros, CMS macros, 
CP control blocks, and CMS control blocks. 
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e¢ System modifications. This should include any changes you have made to 
code provided by IBM. You may have to change these modifications. 


e User-installed tools. 


4. Determine which licensed programs, applications, and modifications are necessary 
and which ones can be replaced or eliminated. 


To find out which programs are used and how often they are used, you can 
either survey your end users or set up an automated procedure. One way to 
automate the procedure is to add a statement to the beginning of each EXEC, 
program, or macro that sends an IUCV *MSG to an IUCV service machine. 
The service machine will then record the number of times an application is 
called. 


¢ Refer to VM/XA SP General Information or contact your IBM 
representative for a list of IBM licensed programs supported by VM/XA SP. 
Determine if these programs offer sufficient functions for your production 
system. Determine the impact of the functions that are not supported. aa 
Order the correct level of the programs that you need, and order any 
prerequisites or corequisites if you do not already have them. 


¢ Contact other software companies about non-IBM products. 


e Determine the impact of converting necessary applications and 
modifications. 


5. Identify specific users or groups of users who will benefit from converting to 
VM/XA SP and the order in which you will convert them. 


Also, identify users who cannot convert to VM/XA SP because they require ao 
functions that are not supported. Plan what you will do with these users; for e. r. 


example, consider running them as users on VM/SP HPO running as a preferred 
guest under VM/XA SP or moving them to a system that is not yet targeted for 
conversion. 


6. Evaluate your service agreements with your end users. 


Can you negotiate for different reliability and availability criteria during the 
conversion period? Also, you may want to warn end users that availability 
means that the system is up, not that all applications are necessarily working. 


7. Understand the impact of major items that are handled differently in VM/XA SP. ' 
| These include: 


¢ The I/O subsystem 

¢ Block paging instead of swapping 

e Saved segment support 

e Spool file formats. 

¢ System scheduling, performance monitoring, and tuning. 


These items, as well as other major differences between VM/SP HPO and 
VM/XA SP, are discussed in Chapter 1, “Overview: Systems Comparison” on 
page 3. 


8. Educate your staff about VM/XA SP. 


Key personnel who need education are: 


e Planners, who require information about what hardware and software is 
supported by VM/XA SP 
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e System administrators, who require information about new and changed 
procedures for controlling system resources 


e Support personnel, who require information about 370-XA architecture and 
VM/XA SP system internals 


¢ Application programmers, who require information about VM/XA SP 
application programming interfaces and 370-XA architecture 


¢ End Users, who require information about VM/XA SP commands that are 
different from VM/SP HPO. See Chapter 7, “Application End Use” on 
page 89 for a list of these commands. 


For information about education that IBM offers, contact your IBM 
representative. 


Order an adequate supply of manuals. See “VM/XA System Product 
Publications” on page 305 for titles and order numbers. 


It is important that managers, support personnel, application programmers, and 
end users understand the changes that will occur when your installation converts 
to VM/XA SP. An understanding of your installation’s goals, the benefits of 
VM/XA SP, and the changes required to convert to VM/XA SP will help your 
organization commit to the project. 


. Create a detailed conversion plan. 


This plan should provide a detailed map of the activities and schedules needed to 
complete a successful conversion. Develop strategies for how you will approach 
the conversion. You must determine: 


e Groups of work items that can be combined and managed together. 
¢ A beginning and an end date for each work item. 


e A reporting structure for managing the conversion process—that 1s, how 
each member of the conversion team reports progress to the person 
responsible for the entire conversion. 


e A strategy for converting to VM/XA SP. This includes: 


— What users or groups of users you will convert and the order in which 
you will convert them 


— How and when you will share DASD 
— What kind of communications network you will implement 
— How you will handle the directory and security of the system 


— How you will test and cut over to the new system. 


10. Create a back-off plan. 


Determine back-off criteria, plans, and schedules. 


11. Understand how application programs need to be changed to run in VM/XA SP. 


IBM provides sample EXECs to help you determine how much work you need 
to do to convert programs to run on VM/XA SP. For more information, see 
Chapter 8, “Application Programming” on page 91 and 

Appendix A, “Conversion Tools” on page 277. 
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12. Communicate. 


Before converting, communicate the conversion plan to the users of your current 
system. During the conversion, communicate the status of the conversion to the 
users of your new system. 


Inform your users of the justifications for the conversion, the benefits of the new 
system, the dates for the main tasks in your conversion plan, the system 

resources that will be unavailable at certain times, and what your users’ role is in 
the conversion process (that 1s, testing their individual applications and EXECs). 


Because much of the impact of the conversion is to applications and EXECs, 
you should involve application programmers in the conversion. They will have 
to check their applications and EXECs, recode them if changes are required, and 
test them. Involve end users, too, because the externals of some system 
functions may change. For instance, the logon procedure changes if you install 
RACF on the new system. 


Some forms of communication are: 
e Classroom education 
e User service representatives 


e A bulletin board facility or conferencing system, which could be 
implemented in several ways: 


— As read-only or help files that users can browse. 


— As a disconnected virtual machine to which users can submit questions 
and comments that are available for all to read and respond to. The 
questions and comments would reside in files, and users would link with 
read access to the minidisks containing these files. As users submit their 
questions or comments (updates), the disconnected virtual machine 
would append the updates to the appropriate file based upon file name 
or file type. 


Conversion Strategies 
The conversion from VM/SP HPO to VM/XA SP will be different from your usual 
migration to a new VM/SP HPO release since VM/XA SP does not run as an 
operating system on VM/SP HPO. As a result, all testing of the CP code must be 
done off-shift or on a separate processor. 


One way to approach this is to choose a pilot group that will move to VM/XA SP 
first; for example, you might choose your system support personnel. Move them to 
VM/XA SP and have them test and debug their applications. Once they are 


running, you can move more and more users until your production workload is 
running on VM/XA SP. 


Splitting workload is one way to implement such a conversion. However, because it 
means that you will have to split your production across several systems, it can cause 
some problems for you. You must determine: 


¢ Whether to use one or two systems 


¢ How users on the VM/SP HPO system will share data with users on the VM/XA 
SP system 


¢ What you will do about the directory, data bases, and security 
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e How users on the VM/SP HPO system can communicate with users on the 
VM/XA SP system 


e If necessary, how you will back off. 


These concerns are addressed in the following sections. 


Should | Use One System or Two? 


Whether to use one or two systems depends on your installation’s configuration and 
hardware. 


When you convert to VM/XA SP, you will need additional capacity on the new 
system to accommodate new functions. 


a Using Two Processors 
( - If you have a separate processor on which you can bring up VM/XA SP or if you 
: | can bring up VM/XA SP on half of a physically partitioned processor, you can 
install and test without affecting your VM/SP HPO production system. 


When you are satisfied with the reliability of the VM/XA SP system, you can move 
the VM/SP HPO workload to production on VM/XA SP. For planning purposes, if 
you are running on the same hardware, it is projected that you will achieve up to 
85% of VM/SP HPO native performance, depending on your configuration and 
workload characteristics. 


( - Your plan might look like this: 


1. If your VM/SP HPO system is processor-constrained, you may need to upgrade 
your processor. 


i) 


. Using your existing VM/SP HPO system, generate a small VM/XA SP system. 
IPL this system on a separate processor or on half of a physically partitioned 
processor. 


3. Use this small VM/XA SP system to test and become familiar with VM/XA SP. 
Once you understand VM/XA SP, generate a larger VM/XA SP system. 


( | 4. Before you convert any CMS users, you should sufficiently test the VM/XA SP 
7 system. Once users convert their applications and begin to exploit VM/XA SP 

CMS, you will have a harder time backing off. To ensure that the system 1s 
stable, you may want to run VM/XA SP for a period of time before you move 
users. During this time, you can train the data processing and operations staff, 
install and test licensed programs, convert service machines and system 
applications, and convert the programmable operator and other automated 
functions. 


5. While you continue the majority of your production work on the separate 
VM/SP HPO system, move the first group of users (probably your data 
processing support group) to VM/XA SP. Have them convert and test their own 
application programs on VM/XA SP CMS. To prepare for a possible back-off, 
either keep a copy of the System/370 versions of applications or code the 
applications so that they run in either architectural mode. 


6. Move more users to VM/XA SP. You might consider moving application 
programmers or a group of people that work independently of others (that is, 
they do not share data bases with a large number of people). Have them 
convert and test application programs on VM/XA SP CMS. 
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7. Continue to move users to VM/XA SP until you have moved everyone that is 
scheduled. If you have some users that cannot go to VM/XA SP because they —_ 
need function that is not available, you may not be able to complete the \ 


conversion until a later release of VM/XA SP. 
Figure 8 depicts this conversion strategy using two processors. 
Phase | Phase Il 
| VM/SP VM/SP 
| HPO CMS | | HPO CMS 
VM/SP VM/SP VM/XA SP 
HPO HPO 
a, 
Phase III Phase IV 
VM/XA SP VM/XA SP 
CMS | CMS 
VM/XA SP | VM/XA SP 
aes 
\ 


Figure 8. Conversion from VM/SP HPO to VM/XA SP Using Two Processors 


| Using One Processor with Logical Partitioning 

| If you have a 3090E processor with the PR/SM feature operating in logically 

| partitioned (LPAR) mode, you can install and test VM/XA SP in one of the 

| partitions without affecting your VM/SP HPO production system that is running in eos 
| another partition. The PR/SM feature allows you to run old and new operating 2 
| systems and application programs in independent logical partitions that are active on 
| the same processor complex at the same time. 


| VM/XA SP Release 2 is supported in LPAR mode for test and development only. 
| This support will be available after general availability of Release 2 and does not 
| include V=F or V=R guest support. 


Using One Processor without Logical Partitioning 
Once you are satisfied with the reliability of your VM/XA SP system, you can install 
VM/SP HPO as a guest and migrate users to VM/XA SP. 


For planning purposes, you may make the following assumptions. If you take the 
entire VM/SP HPO workload and run it in a VM/SP HPO virtual machine under 
VM/XA SP on a non-3090E processor, it is projected that you will achieve up to c 
60% of VM/SP HPO native performance. If you take the entire VM/SP HPO ‘a 
workload and run it in a VM/SP HPO virtual machine under VM/XA SP ona 

| 3090E processor without the Processor Resource/Systems Manager (PR/SM) feature, 
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it is projected that you will achieve up to 80% of VM/SP HPO native performance. 
If you have the PR/SM feature operating in ESA/370 mode, it is projected that you 
will achieve up to 90% of VM/SP HPO native performance (assuming a V=R or 
V=F guest). Your specific system performance may vary due to workload, I/O 
configurations, or hardware. 


To reduce the workload running in the VM/SP HPO virtual machine under VM/XA 
SP, consider moving some users to the VM/XA SP production level right away. 


You tune the VM/SP HPO preferred guest the same way that you tuned the VM/SP 
HPO native system. 


In summary, if you are constrained on your current processor (that is, storage, I/O, 
processor), you should consider upgrading your system before you convert. 


Example: If you are 95% processor-constrained running your VM/SP HPO system 
on a 3081 processor, you might consider moving to a 3090 Model 200E processor. 
This would reduce the processor utilization to near 62%, providing the additional! 
capability that you will need to grow with VM/XA SP. 


Your conversion plan might look like this: 


1. If your VM/SP HPO system is constrained, you may need to upgrade your 
equipment. 


2. Using your existing VM/SP HPO system, generate a small VM/XA SP system. 
Re-IML the processor and IPL the VM/XA SP system off-shift on the same 
processor. 


Use this small VM/XA SP system to test and become familiar with VM/XA SP. 
Once you understand VM/XA SP, generate and test a larger VM/XA SP system. 


Throughout this effort, you must test off-shift and restore your VM/SP HPO 
system for production work until you are satisfied with the VM/XA SP system 
reliability. 


A technique you can use to shorten a test is to avoid dumping and restoring 
spool files before and after the test, provided this 1s acceptable to your users. In 
order to do this you must: 


¢ Notify users who will be testing that they will not have their spool files 
available during the test. If they require their spool files for the test they 
must process them prior to the changeover. 


¢ Bring up VM/XA SP without the spool files. 


¢ Upon completion of the test, use SPTAPE to dump the spool files created 
during the test. 


° After bringing up your VM/SP HPO production system again, use SPTAPE 
to restore the spool files that you dumped during the VM/XA SFP test. 


3. When you are satisfied with the VM/XA SP system’s reliability, load your 
VM/SP HPO system as a V=R preferred guest operating system in the new 
VM/XA SP environment. 


4. Before you convert any CMS users, you should sufficiently test the VM/XA SP 
system. Once users convert their applications and begin to exploit VM/XA SP 
CMS, you will have a harder time backing off. To ensure that the system is 
stable, you may want to run VM/XA SP for a week or so before you move 
users. During this time, you can train the data processing and operations staff, 


Chapter 2. Planning for Conversion 31 


VM/SP HPO Conversion 


Phase | 


install and test licensed programs, convert service machines and system 
applications, and convert the programmable operator and other automated 
functions. 


5. While you continue the majority of your production work on the preferred 
guest, move the first group of users (probably your data processing support 
group) to native VM/XA SP. Have them convert and test their own application 
programs on VM/XA SP CMS. To prepare for a possible back off, either keep 
a copy of the System/370 versions of applications or code the applications so 
they run in either architectural mode. 


6. Move more users to VM/XA SP. You might consider moving application 
programmers or a group of people who work independently of others (that is, 
who do not share data bases with a large number of people). Have them 
convert and test application programs on VM/XA SP CMS 5. 


7. Continue to move users to VM/XA SP until you have moved everyone that is 
scheduled. If you have some users who cannot go to VM/XA SP because they 
need functions that are not available, you may need to maintain a VM/SP HPO won 
guest and complete the conversion at a later release of VM/XA SP. ‘ 


Figure 9 depicts the conversion scenario using one processor. 


Phase Il Phase II] Phase IV 


Pa 
; Na / 
VM/SP HPO VM/XA SP 
CMS | CMS 
VM/SP HPO VM/XA SP | > | VM/XA SP VM/XA SP 
Figure 9. Conversion from VM/SP HPO to VM/XA SP Using One Processor 
Neo 


Creating a Pilot Production System 


Depending on the conversion strategy you choose, you might want to create a 
VM/XA SP pilot production system from the original production system. The pilot 
production system could be in a separate partition or on a separate processor; it 
could not be a guest. After the regular production system is converted to VM/XA 
SP, the pilot production system could be merged back into the original production 
system. 


A major concern for the users of the pilot system would be that if their node IDs 
change they would not get spool files and PROFS documents that are inadvertently 
sent to the old node ID. To avoid this problem, it is possible to make user IDs on 
the pilot node appear to the network as though they still reside at the original node. 


Consider the following items when attempting to create the pilot system from the 
original system: 


¢ Spool files (CMS notes, PROFS notes, SENDFILE files, and so forth) 
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| ¢ PROFS documents 
ee . | PROFS calendar access 
( : | e Data shared via links 
= | ¢ Data base access. 


| Spool Files 
| In order to make the change in systems unnoticeable to those sending and receiving 
| spool files, you can do the following. 


| On the original system: 


| ¢ Do not delete IDs of users who have moved to the pilot system. You want them 
| to be able to receive spool files on the original system but to be prevented from 

| logging on to the original system. You can do this by changing the users’ 

| passwords without telling them their new passwords or, if RACF is installed, by 
| having the ID RACF revoked. 


| e Set up a service machine with the appropriate privilege class to transfer spool 

| files to the pilot system. The service machine should transfer, at an 

| installation-determined interval, the files in the readers of the IDs that were 

| migrated to the pilot system by tagging the files with the ID of that node. You 
| can use a table lookup to determine which IDs are to receive this treatment. 


| The files transferred from the original system appear in the reader of the pilot 
| machine just as if they were sent there directly. 


On the pilot system: 


ae e Have the users update their nickname files to include both node and ID so that 
( files can be sent to user IDs that remain on the original system. 


PROFS Documents 
If PROFS is installed, PROFS documents must also be transferred to users on the 
pilot system. To do this: 


I. Move the PROFS document data base to the pilot system as follows: 
| a. Copy the data base. 


ee | b. Within the new document data base, use XEDIT to change node ID 
( | references to reflect the pilot node ID instead of the original node ID. 


| 2. Transfer documents to IDs on the pilot system by using the PROFS 

| EPRERELN user exit for all nodes in the network that send PROFS documents 
to the pilot system. The exit invokes a user-written EXEC that does a table 
lookup using node and ID as the argument to determine, for the pilot users 
only, which PROFS MAILMAN should receive the documents. | 


3. When pilot production has ended, merge the documents created on the pilot 
| system back into the production system data base as follows: 


| a. On the pilot system, use an ID with link privileges to all PROFS user IDs to 
| invoke a user-written EXEC that extracts, from each ID’s mail log, the 

| documents created during pilot system operation and sends them back to the 
| original system. The EXEC could use a table of IDs to do this for each 

| PROFS ID on the pilot system. 


| b. On the original system, read in the PROFS documents sent back from the 
| pilot system. 
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PROFS Calendar Access 
To migrate the calendar data to the pilot system, the files that represent individual 
months per user must be transferred to that system. You can do this using RSCS. 
You can use the same process to migrate the pilot users back when pilot production 
ends. | | 


Users at the two systems will no longer be able to see one anothers’ calendars as 
they could when integrated into a single system. 


Data Shared via Links 
| Minidisks shared between the two systems must be controlled so that accessing a 


minidisk for write from both systems at the same time cannot happen. This can be 
done using RACF. 


Data Base Access 
Data bases, such as PROFS and SQL data bases, cannot be shared. All activity 
must be from one of the two systems for a given data base. 


Some products with nonshared data bases, such as PROFS and SQL, do not permit 
coalescence (merging) of data if a return to one common data base is required. For 
example, if the original system has a PROFS document data base and you create one 
on the pilot system for users you move there, you cannot merge the pilot system 
data base back into the original system data base when you move the pilot system 
users back to the original system. 


What If | Have a Guest Operating System Running on VM/SP HPO? 


If you have an operating system, such as MVS, running on VM/SP HPO, you should 
install it as a guest operating system on VM/XA SP rather than as a guest operating 
system on a VM/SP HPO guest running under VM/XA SP. Be aware, though, that 
you have to convert any EXECs used by your operations personnel to run on 
VM/XA SP CMS and that you may have to change other operational procedures. 


How Can VM/SP HPO and VM/XA SP Users Share Data? 


If you migrate users from the VM/SP HPO system to the VM/XA SP system in a 
staged fashion, your production will be split between several systems. One major 
concern is how you will share data between these systems. 


VM/XA SP software allows you to share information on a DASD volume in the 
following ways: 
¢ Between multiple virtual machines using virtual reserve/release. 


¢ Between one virtual machine and operating systems running on other processors 
using real reserve/release. 


¢ Between multiple virtual machines and operating systems running on other 
processors using concurrent virtual and real reserve/release. The virtual 
machines and operating systems must support real reserve/release CC Ws. 


Virtual reserve/release, real reserve/release, and concurrent virtual and real 
reserve/release all work the same way in VM/XA SP as they do in VM/SP HPO. 
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The sections that follow include examples of virtual reserve/release and concurrent 
a virtual and real reserve/release. For a complete discussion, refer to VM/XA SP 
( : Planning and Administration. 


What If We Cannot Share Data through Reserve/Release? 
In some instances, you will not benefit from or will not be able to share DASD 
through VM/XA SP’s reserve/release. For instance, if: 


¢ You need to share data between multiple virtual machines on multiple systems 
and the operating systems running in the virtual machines do not support 
concurrent virtual and real reserve/release. CMS is an example of a virtual 
machine that does not support this type of sharing. 


¢ Your system is constrained and you cannot afford the performance degradation 
that results from shared DASD (particularly concurrent virtual and real 
reserve/release). 


- e You need to share data bases (such as SQL or APL) between several groups of 
( es users and not all of the users can be moved to VM/XA SP. 


¢ There are incompatibilities that prevent VM/SP HPO and VM/XA SP from 
accessing the same data. This is the case with the user directory. 


In these cases, you might: 
e Replicate the data. 


¢ Maintain the data on one system only and give two user IDs to users who need 
to access the data. 


Do e Physically attach the DASDs you want to share to the second system and allow 
( write access from only one system. If you have RACF, you can use it to find 
out who has access and to limit the write access from one system. You should 
be aware however that this method of sharing is not protected by VM/XA SP 
software; you must set up the controls yourself. 


How Do | Share Data between Multilevel Virtual Machines? 


Using Virtual Reserve/Release 
‘ | If you want to share data between virtual machines running under VM/XA SP that 
( support virtual reserve/release, and you do not need to share this data with operating 
systems running on other processors, use virtual reserve/release. MVS is an example 
of a virtual machine that supports virtual reserve/release. CMS is an example of a 
virtual machine that does not support virtual reserve/release. 


Virtual reserve/release works the same way in VM/XA SP as it does in VM/SP HPO. 
Figure 10 on page 36 depicts MVS virtual machines sharing DASD through virtual 
reserve/release. : 
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VM/SP HPO 
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Figure 10. Sharing DASD Using Virtual Reserve/Release 


On the VM/SP HPO guest: 


1. Define the DASD as a minidisk for one of the virtual machines, perhaps A, in 
the VM/SP HPO directory. Specify MWV as the access mode on the MDISK 
statement. 


2. Code the LINK statement for the remaining virtual machine, B, in the VM/SP 
HPO directory. Specify MW as the access mode. 


On the VM/XA SP system: 


1. Define the DASD where the minidisk resides on the RDEVICE macro in 
HCPRIO and on the SYSCPVOL or SYSUVOL macro in HCPSYS. 


2. Code the MDISK statement in VM/SP HPO’s directory entry in the VM/XA SP 
directory. You must append a V to the primary access mode (read, write, 
multiple write, and so on) indicating that this minidisk can be shared between 
virtual machines. For example: | 


MDISK 197 3350 000 400 WORKPK MWV GANDALF 
3. Code the LINK statement in Y and Z’s directory entry. For example: 
LINK HPQ 197 197 MW 


4. Specify that the DASD will not be shared with another operating system. The 
default setting of the SHARED option of the RDEVICE macro 
(SHARED = NO) takes care of this for you. 


Now, virtual machines running in the VM/SP HPO virtual machine under VM/XA 


SP may have write access to the same information as virtual machines running on 
VM/XA SP. 
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Without Using Virtual Reserve/Release 
If you want to share data between virtual machines running under VM/XA SP and 
the virtual machines do not support virtual reserve/release, such as CMS, you cannot 
use virtual reserve/release. You define the DASD as a minidisk, giving read/write 
access to only one of the CMS users running on the VM/SP HPO guest; the others 
can only have read access. This is shown in Figure 11. 


oes ae 
DASD 


CMS |CMS | CMS | CMS| CMS | CMS 


oe eee 


VM/SP HPO 


( i VM/XA SP 


Figure 11. Sharing DASD without Using Virtual Reserve/Release 


On the VM/SP HPO guest: 


1. Define the DASD as a minidisk for one of the virtual machines, perhaps A, in 
| the VM/SP HPO directory. Specify MW as the access mode on the MDISK 
| | statement. 


( 2. Code the LINK statement for the remaining virtual machines, B and C, in the 
: | VM/SP HPO directory. Specify RR as the access mode. 
On the VM/XA SP system: 


1. Define the DASD where the minidisk resides on the RDEVICE macro in 
HCPRIO and on the SYSCPVOL or SYSUVOL macro in HCPSYS. 


2. Code the MDISK statement in VM/SP HPO’s directory entry in the VM/XA SP 
directory. Do not append a V to the primary access mode. For example: 


MDISK 197 3350 000 400 WORKPK MW GANDALF 
3. Code the LINK statement in X, Y, and Z’s directory entry. For example: 
LINK HPO 197 197 R 


4. Specify that the DASD will not be shared with another operating system. The 
default setting of the SHARED option of the RDEVICE macro 
(SHARED = NO) takes care of this for you. 
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Now, virtual machines running in the VM/SP HPO virtual machine may have read 


access to the same information as virtual machines running on VM/XA SP. 


How Do | Share Data among Virtual Machines and Other Systems? 
To share data among multiple virtual machines running under VM/XA SP and other 


systems, use concurrent virtual and real reserve/release support. You can only use 


this, however, if the virtual machines that are sharing the data support 


reserve/release. In the example shown in Figure 12, the MVS virtual machines 


running under VM/XA SP can share DASD with the MVS virtual machine running 
under VM/SP HPO in this manner. The CMS virtual machines cannot share DASD 


because CMS does not support virtual and real reserve/release concurrently. You 


have to replicate the data for the CMS users or physically attach the DASD and give 
write access to only one system. 


Replicated 


DASD 


Concurrent virtual and real reserve/release support can be invoked either during 
system generation or at any time while the system is running. 


Do the following to invoke concurrent virtual and real reserve/release while 


Shared 


Of \ 


CMS |CMS | MVS MVS | MVS | CMS 


VM SP HPO | VM/XA SP 


Figure 12. Sharing DASD between Virtual Machines on Multiple Systems 


generating the system: 


ae 
DASD 


Replicated 


1. Ensure that the operating system running under VM/XA SP and the operating 


system with which you are sharing the DASD both support reserve/release 


CCWs. 


. Define the DASD as a shareable full-pack minidisk. To do this, use the 
MDISK statement in the directory. 


To define the DASD as a full-pack minidisk, the starting cylinder number must 


be zero and the number of cylinders must equal or exceed the number of 


cylinders on the real device. To define the DASD as virtually shareable, include 


the “V” in the mode definition. For example: 


MDISK 327 3380 000 885 MVSO03 MWV 
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3. Define the DASD as being shareable between multiple real and virtual systems 
by specifying the SHARED = YES option on the RDEVICE statement in 
HCPRIO ASSEMBLE. For example: 


RDEVICE DEVNO=0327 ,DEVTYPE=3380, SHARED=YES 


Note: The default for the RDEVICE SHARED operand is NO. Therefore, this 
support is not automatically invoked. 


If the system terminates due to a hard abend or a machine check, CP attempts to 
restart with the V=R virtual machine “intact.” VM/XA SP V=R recovery differs 
from that in VM/SP HPO. In VM/XA SP, CP restores the V=R user’s current I/O 
configuration rather than, as in VM/SP HPO, the I/O configuration defined in the 
V=R user’s directory entry. This means that the V=R user recovers the reserves 
and links to all the dedicated devices and full-pack minidisks to which it is linked at 
the time of the crash. 


You cannot use concurrent virtual and real reserve/release support with VM/SP 
HPO if you generate VM/SP HPO devices with alternate paths. The definition of 
alternate paths in DMKRIO and the use of hardware-supported reserve/release are 
mutually exclusive. (Alternate paths are supported differently in VM/XA SP; they are 
supported in the hardware rather than the software.) 


Minidisk Caching Consideration 


To provide virtual machines with fast access to data on minidisks, VM/XA SP 
supports the caching in Expanded Storage of the most recently used data blocks 
from non-full-pack minidisks. However, to guarantee data integrity, minidisk 
caching should be disabled for any minidisk that is shared between two systems 
when one or both systems have write access to the minidisk. 


In VM/SP HPO, the default is for minidisks not to use cache. But in VM/XA SP, 
the defauit is for minidisks to use cache. To disable caching for an individual 
minidisk, specify the NOMDC parameter on its MINIOPT directory control 
statement. To disable caching for all minidisks, issue the command RETAIN 
XSTORE MDC OFF. (If you use this command you should place it in the 
AUTOLOGI PROFILE.) 


How Do | Share Data between CMS Users on Multiple Systems? 


VM/XA SP software does not allow you to share data on a DASD volume between 
CMSs running on multiple systems. 


With VM/SP HPO, you can use VM/Inter-System Facilities (VM/ISF) to share 
access to minidisks among CMS users on different systems as if they were all on the 
same system. While converting to VM/XA SP, you might consider using this to 
provide shared minidisk access between CMS users on a native VM/SP HPO system 
and CMS users running on a VM/SP HPO guest on VM/XA SP. However, you 
cannot use VM/ISF to provide shared minidisk access between CMS users running 
on VM/SP HPO and CMS users running native on VM/XA SP. In this case, you 
must replicate the data for the VM/XA SP CMS users or physically attach the 
DASD and allow write access from one system only. As mentioned previously, if 
you physically attach the DASD, you must ensure that multiple systems do not have 
write access. There is no software protection. 
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If you decide to replicate data, you must move or copy data as you move users to 

VM/XA SP. This is easier to do if you have groups of users that work 

independently of other groups. In this case, you can move the data from one DASD 

to another as you move the group without having to keep a copy of the data for 
users that are still running on VM/SP HPO. 


The problem arises when you have multiple groups of users that rely on the same 
data and not all the users can be migrated to VM/XA SP at the same time. For | 
example, if your purchasing, inventory control, and personnel departments all use 
the same data bases and the personnel department cannot be migrated to VM/XA 
SP because they require unsupported function, you would need to manually update 
two copies of the data bases. This would be an impossible task if the information is 
updated frequently or by several groups or if the information is critical. In this case, 
you would need to keep the data base on the VM/SP HPO systems so personnel 
could access it and give two user IDs to the purchasing and inventory groups so they 
could work on VM/XA SP but access VM/SP HPO when they needed the shared 
data. | 


Shared using VM/ISF 
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Figure 13. Sharing and Replicating DASD for CMS Virtual Machines 


What Should | Do with the User Directory? 


You cannot use the same object directory for your VM/SP HPO and VM/XA SP 
systems because they are incompatible. So, you must either: 


e Have one source directory and issue either the DIRECT command or the 
DIRECTXA command with the MIXED option depending on which object 
directory you want online. DIRECT will bring the 370 directory online. 
DIRECTXA will bring the 370-XA directory online. Put the VM/SP HPO 
object directory on any VM/SP HPO CP-owned volume, and the VM/XA SP 
object directory on any VM/XA SP CP-owned volume. 


VM/XA System Product Conversion Notebook 


elise a uevhce beak si a 


VM/SP HPO Conversion 


¢ Keep two copies of the source directory. If you do this, you will have to 
; manually update the directories to ensure that changes made to one directory are 
( reflected in the other. 


To provide a back-off plan for CMS users, you may want to keep the users that are 
targeted to go to VM/XA SP in both the VM/XA SP and VM/SP HPO directory 

; (either the VM/SP HPO guest or the separate VM/SP HPO system) until you are 
convinced that the users will not need to back off. 


Refer to “Converting the User Directory” on page 49 for a complete discussion of 
converting your VM/SP HPO directory for use on VM/XA SP. 


Placing the User Directory on a CP-Owned Volume 
VM/XA SP allows you to place the user directory (that is, the output of the 
DIRECTXA command, also called the “object directory”) on any CP-owned 
volume. Because the system queries the user directory when the system needs to 
on validate a user ID (for instance, when a user logs on or issues a LINK command), 
( : the DASD volume on which the user directory resides gets a lot of activity. Place 
. the user directory on a fast device such as a DASD attached to a 3880-23 control 
unit. 


What Should | Do with Data Bases? 


Since VM/XA SP does not support TSAF and APPC/VM, your VM/SP HPO 
systems cannot share data bases with a VM/XA SP system. If you have a large 
| group that uses a data base such as SQL or APL, you will either have to (1) move 
( all the users to VM/XA SP at once along with the SQL data base or (2) keep the 
i data base on the VM/SP HPO and maintain two user IDs so users system can log on 
to VM/SP HPO to access the SQL data base. 


What Should | Consider in a Back-Off Plan? 


When planning your migration to VM/XA SP, you must also plan how you will 
back off if you run into a problem. You will need two types of back off plans: one 
for system problems and one for virtual machine problems. 


( | The system back off plan 1s needed when you run into a problem with VM/XA SP, 
such as an abend from which you cannot recover. In this case, you will need to be 
able to quickly re-IPL a VM/SP HPO system. 


The virtual machine back off plan is needed when a user or group of users cannot 
run on VM/XA SP (for example, if application programs will not operate on 
VM/XA SP CMS). In this case, you will need to be able to quickly move the user 
or group of users to a VM/SP HPO system. 


Once you determine your back off plan, negotiate back off criteria with your end 
users. Publish the approved plan. 
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Backing Off because of System Problems 


Format/ Allocate 


If you run into a problem with VM/XA SP that forces you to back off and you have 
not yet exploited VM/XA SP-only functions or migrated CMS users, the back off 
will not impact your end users. If, on the other hand, you run into a problem and 
have to back off after you have migrated CMS users, you will greatly impact these 
users. Once users convert their applications to run on the VM/XA SP CMS, they 
may not be able to run these applications on the VM/SP HPO CMS. Therefore, you 
should not migrate users to VM/XA SP until you are satisfied with its reliability. 


Throughout the conversion effort, you should maintain your VM/SP HPO system 
residence (SYSRES) volume and CP-owned packs. Then, if you need to back off, 
you can easily do so. Plan to build a small, one-pack VM/XA SP system. Once you 
have fully tested VM/XA SP, you can generate a larger system. 


If you must back off from VM/XA SP and IPL a VM/SP HPO system, do the 
following: 


1. SPTAPE DUMP spool files. 


2. If you have not maintained your VM/SP HPO CP-owned DASD, reformat 
cylinder 0 and reallocate enough CP-owned DASD to bring up VM/SP HPO. 
(The allocation maps are different between VM/SP HPO and VM/XA SP. Refer 
to Table 9 on page 52 for a comparison of allocation options.) 


Since you cannot reformat and reallocate paging and spooling packs to which 
you are currently attached, you must: 


e Shut down the system 

° Re-IPL it with the CP-owned DASD (that vou plan to reformat) offline 
e Attach the DASD to a virtual machine 

e Reformat cylinder 0 and reallocate. 


3. If you have not maintained a separate directory on the VM/SP HPO SYSRES 
pack, redirect the directory using the DIRECT command so it can be used on 
the VM/SP HPO system. 


. Shutdown the VM/XA SP system. 
. Re-IML the processor to System/370 mode. 
. IPL VM/SP HPO. 


SI NSN WN BH 


. If necessary, reformat cylinder 0 and reallocate the remainder of your VM/SP 
HPO CP-owned DASD. Either re-IPL or physically attach the DASD to the 
system. 


8. SPTAPE LOAD spool files. 


9. Enable terminals. 


When you convert to VM/XA SP from VM/SP HPO, you must reformat cylinder 0 
and reallocate the CP-owned DASD for VM/XA SP use. When backing off from 
VM/XA SP to VM/SP HPO, you must reformat cylinder 0 and reallocate the 
CP-owned DASD for VM/SP HPO use. 


If you back off from your VM/XA SP system and IPL your VM/SP HPO 4.2 or 5 
system without reformatting cylinder 0 or reallocating the DASD, VM/SP HPO will 
not issue an error message informing you that the DASD is incorrectly formatted or 
allocated. Instead, the system will come up with the DASD offline. If you try to 
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attach the DASD to your system using the ATTACH command, the DASD will be 
attached, but it will not be CP-owned. If you reformat cylinder 0 and reallocate the 
DASD, you can successfully attach the DASD to the system and it will be 
CP-owned. 


When you are ready to go back to the VM/XA SP system, load the CPFMTXA 
module from the VM/XA SP starter system onto your VM/SP HPO system. You 
can then reformat cylinder 0 and reallocate DASD (except for 3880-G21s) to 
VM/XA SP format. (If you have any 3880-G21s, you have to wait until VM/XA SP 
is running again to reformat and reallocate them. You cannot do this while running 
on VM/SP HPO.) 


Directory Concerns 
Prior to backing off, issue the DIRECT command to bring the VM/SP HPO 
directory online. If you do not do this, you have to use the VM/SP HPO 
stand-alone directory function in order to IPL VM/SP HPO. 


SPTAPE 
You must SPTAPE DUMP the spool files so you can restore them to your VM/SP 
HPO system. 


Backing Off Individual Users because of Problems with Application Programs 
Once the system is stable, you will begin to migrate CMS users. To prepare for a 
possible back off, either dual-path the code or keep copies of the System/370 
versions of applications. 


Directory Concerns 
If a user or group of users has problems running applications on VM/XA SP CMS, 
you will need to back off these users to VM/SP HPO. To plan for this, keep a 
directory entry ina VM/SP HPO system for each VM/XA SP user until you are 
satisfied that the users are running smoothly. You can use either a VM/SP HPO 
guest or a separate VM/SP HPO system as the back off system. This will be extra 
work for you but will cause the least impact for the end users if they run into 
problems. 


If you are using two source directories, you must remember to reflect changes made 
in one directory to the other directory. 


SPTAPE 
You must SPTAPE the user’s or group of users’ spool files and restore them to the 
VM/SP HPO system. 


One Customer’s Experience 


One customer reports the following conversion scenario. 


The customer had a VM/SP HPO Release 4.2 system supporting several hundred 
users who used a variety of engineering, scientific, and office applications. A small 
but very important group required the capabilities of 370-XA for their applications. 
The customer decided to have all the applications support all users in 370-XA mode 
(and none in System/370 mode), with some applications in the 370-XA toleration 
stage (24-bit) and the rest in the 370-XA exploitation stage (31-bit). This was to 
avoid having end users re-IPL CMS between mode changes. 
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The customer then installed VM/SP HPO Release 4.2 as a preferred guest on 
VM/XA SP. Dedicated DASD and Expanded Storage are now used to maintain 


performance levels. There is one shared DASD between VM/XA SP and the VM/SP fo 
HPO guest. “S 
_ The customer divided the VM/SP HPO users into three groups based on their 
application use: planners and administrators in one group, engineering and scientific 
application users in the second group, and program developers in the third group. 
As 370-XA capable applications are announced by IBM and others, the customer 
will analyze each group and plan the move to 370-XA CMS when their application 
set is complete (that is, able to run in 370-XA mode). This should result in a 
gradual and orderly transition expected to be completed in about 12 months. | 
| 
i a 
Nw Y 


44 VM/XA System Product Conversion Notebook 


lptehieiae Yale eth je os the x to Pee Sm eR ee Spt Gl AE PEM snake eR al enearhdan”  savcoeaa en arate Sn we et ie reli SEE a ee eo latin la os . cearare 


VM/SP HPO Conversion 


Chapter 3. Installation and Service 


The installation procedure for VM/XA SP is much like the EXEC-driven procedure 
you used in VM/SP HPO. There are only minor procedural differences. 


You should install your VM/XA SP system by using the starter system. You could 
instead start with your existing VM/SP HPO system, but this is a more difficult 
procedure than using the starter system. Refer to VM/XA SP Installation and 
Service for instructions on using the starter system. 


This chapter provides a checklist of items to keep in mind when installing VM/XA 
SP under an existing VM/SP HPO system. 


Installing Assembler H Version 2 Licensed Program 


Before generating the CP nucleus, you must install Assembler H Version 2 Licensed 
Program. Refer to VM/XA SP Installation and Service for details. 


Converting System Generation Files 


Before generating the CP nucleus, you must convert system generation files. 


Converting DMKSYS to HCPSYS 


In VM/XA SP, you use HCPSYS to define many of your installation’s operating 
characteristics. Table 5 summarizes the differences between DMKSYS and 
HCPSYS. Refer to VM/XA SP Planning and Administration for a complete 
discussion of HCPSYS ASSEMBLE. 


~ 


Table 5 (Page 1 of 3). Comparison of DMKSYS and HCPSYS 


VM/SP HPO | VM/XA SP oe of Change Introduced by VM/XA 
DMKSYS HCPSYS 


SYSXSTOR Not supported. Expanded Storage is handled 
differently in VM/XA SP than it is in VM/SP 
HPO. You allocate it to users using the 
XSTORE directory control statement. There is 
no system generation macro to define it to CP. 


SYSPAG _|_: ----- Not supported. You allocate CP-owned DASD 
for paging using CP or CMS commands 
(CPFORMAT or CPFMTXA). You do not 
have to further define these DASD volumes, as 


you do in VM/SP HPO, using a system 
generation macro. 


SYSRES SYSRES SYSCLR, SYSERR, and SYSSPL (SYSSPL is 

| VM/SP HPO Release 5 only) are not 
supported. Also, not all VM/SP HPO device 
types are supported. 
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| Table 5 (Page 2 of 3). Comparison of DMKSYS and HCPSYS 


VM/SP HPO | VM/XA SP | Description of Change Introduced by VM/XA 

DMKSYS HCPSYS SP 

SYSMON Not supported. In VM/XA SP, you specify all 
monitor collection parameters while the system 
is running using the MONITOR command. 


SYSJIRL Not supported. Journaling is handled 

differently in VM/XA SP; it is handled by 

RACF rather than by a system generation 

macro. 7 

SYSCOR SYSSTORE | AP, FREE, MP, PRIME, and RSSIZE are not 
supported. The number of digits that you 
specify for the existing operands is different. 
| RIO370, VRFREE, and VRSIZE are new 
| operands. 


SYSOPR | SYSOPR In VM/XA SP, SYSDUMP is a separate 
HCPSYS macro rather than an operand on the 


SYSOPR macro. 
Performs the same function as the SYSDUMP 
SYSACNT SYSACNT 


operand on the VM/SP HPO SYSOPR macro. 
SYSTIME SYSTIME 


New in VM/XA SP. It identifies the user ID of 
the virtual machine that receives error records. 


USERID 1s the only supported operand. This 
is the user ID of the virtual machine to receive 
the records. 


Basically the same. In some cases, the time 
zone differential, coded on the ZONE operand, 
must be entered in a slightly different manner. 


|} SYSFORM SYSFORM | An additional operand, DEFRDR, 1s | 
supported. 
SYSPCLAS SYSPCLAS | No change. 


SYSID | SYSID No change. 


SYSMIH The missing interrupt handler is handled 
| differently in VM/XA SP. You do not define 
the time interval using a system generation 
macro. 


SYSFCN SYSFCN The PRIV operand is not supported. 


----- SYSUVOL New in VM/XA SP. It provides a list of user 
DASD volumes which, if online, will be 
automatically attached to the system at 
initialization time. 


ae SYSMAXU | New in VM/XA SP. It specifies the user log on | 
limit. 
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Table 5 (Page 3 of 3). Comparison of DMKSYS and HCPSYS 


VM/SP HPO | VM/XA SP | Description of Change Introduced by VM/XA 
DMKSYS HCPSYS SP 


SYSLOCS SYSEND Changed for VM/XA SP. SYSEND, like 
SYSLOCS, must be the last macro specified. 


SYSEND, however, merely signifies the end 


while SYSLOCS generates interna! pointer 
variables in addition to signifying the end. 


To help convert your DMKSYS statements to HCPSYS, use either the COMPSCAN 
SAMPEXEC or FILECONV SAMPEXEC. These are sample EXECs that are 
shipped on the product tape. 


COMPSCAN SAMPEXEC flags incompatible statements. This gives you an 
estimate of how much work is required. 


( | FILECONV SAMPEXEC converts a VM/SP HPO file to a VM/XA SP file. For 
example, when converting DMKSYS to HCPSYS, you can use FILECONV along 
with the CONVSYS SAMPCMDS file to change SYSOWN to SYSCPVOL, to 
change SYSLOCS to SYSEND, to delete SYSXSTOR and SYSPAG (the tool 
actually comments out unsupported statements), and so on. FILECONV flags 
statements that require your judgement. 


Refer to Appendix A, “Conversion Tools” on page 277 for a complete discussion of 
the COMPSCAN or FILECONV sample EXECs. 


Converting DMKRIO to HCPRIO 
In VM/XA SP, you use HCPRIO to define your installation’s real I/O configuration. 


HCPRIO has two macro instructions: RDEVICE and RIOGEN. Like VM/SP 
HPO, the RDEVICE macro defines each real I/O device or group of I/O devices and 
the RIOGEN macro defines the primary and alternate system consoles and 
completes the real I/O definition. (That is, RIOGEN must appear as the last macro 
instruction before the END statement.) 


( Table 6 summarizes the differences between DMKRIO and HCPRIO. 


Table 6 (Page 1 of 2). Comparison of DMKRIO and HCPRIO 


VM/SP HPO | VM/XA SP | Description of Change Introduced by VM/XA 
DMKRIO HCPRIO SP 


CLUSTER Not supported because binary synchronous 
| communication lines are not supported by 
| native communication support. If specified, 
| this macro produces a message saying that it is 
| not supported. 


TERMINAL Not supported because binary synchronous 
| communication lines are not supported by 
| native communication support. If specified, 
| this macro produces a message saying that it is 
| not supported. 
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Table 6 (Page 2 of 2). Comparison of DMKRIO and HCPRIO 


VM/SP HPO | VM/XA SP | Description of Change Introduced by VM/XA 
DMKRIO | HCPRIO SP 


| RDEVICE | RDEVICE The ALTCU, CLUSTER, CPTYPE, and 
DPMSIZE operands are not supported. You 

| define device types using the DEVNO operand 
rather than the ADDRESS operand. Not all 
VM/SP HPO device types are supported on the 
DEVTYPE operand. The device classes coded 
on the CLASS operand are different. The FCB 
CHARS, and IMAGE operands are maintained 
for compatibility purposes only. In VM/XA 
SP, IBM-supplied FCBs and UCSs are shipped 
in image libraries. Or you can generate your 
own FCBs and UCSs using the IMAGELIB 
and IMAGEMOD commands. 


RCTLUNIT | ----- Not supported. You do not need to specify 
alternate control units. The hardware handles 
this. If specified, this macro produces a 
message saying that it is not supported. 


RCHANNEL Not supported. You do not need to specify 
alternate channels. The hardware handles this. 
If specified, this macro produces a message 

saying that it is not supported. 


RIOGEN RIOGEN The SRF operand is not supported. 


To help convert your DMKRIO statements to HCPRIO, use COMPSCAN 
SAMPEXEC. COMPSCAN flags the control statements that VM/XA SP doesn’t 
‘support. Refer to Appendix A, “Conversion Tools” on page 277 for a complete 
discussion of the use and syntax. 


If you have remote clusters configured on your VM/SP HPO system on the 
CLUSTER and TERMINAL control statements, you will need to reconfigure. Since 
VM/XA SP does not support binary synchronous communication lines, you must set 
them up through VM/Pass-Through. To do this, code the RDEVICE statement for 
the binary synchronous line address and then attach it to VM/Pass-Through. Define 
the terminals to VM/Pass-Through in VM/Pass-Through’s configuration file. 


As mentioned in the planning section, you may want to change your I/O 
configuration to take advantage of the architectural differences. 


Converting DMKSNT 


VM/XA SP does not have an equivalent system definition file for the systems name 
table. Instead, you generate saved systems, saved segments, and image libraries 
using CP commands. As a result, converting DMKSNT statements to the equivalent 
VM/XA SP commands (see Table 7 on page 49) is an administrative task rather 
than an installation task. This is discussed in “Managing Saved Segments” on 

page 61. 
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Table 7. Defining Saved Systems, Saved Segments, and Image Libraries 


NAMESYS DEFSYS and DEFSEG commands. 
commands. 


NAMELANG 1s not supported. 
However, the function is now in the 
CMS LANGGEN command. 


NAMELANG (VM/SP HPO Release 
5 only) 


Converting the User Directory 


Table 8 summarizes the differences between the VM/XA SP directory and the 
VM/SP HPO directory. 


Table 8 (Page 1 of 3). New and Changed User Directory Control Statements 


Description of Change Introduced by 
VM/SP HPO VM/XA SP VM/XA SP 
DIRECTORY | DIRECTORY | Not all VM/SP HPO device types are 
supported. 


USER USER Uses different reserved user IDs. In 


addition to the password, VM/XA SP has 
OPTION OPTION 


NOLOG and NOPASS. In VM/SP HPO, 
you can define up to eight classes. In 
VM/XA SP, you can define as many as will 
fit on the line. If you want to define even 
more, use the CLASS statement. 


AFFINITY, BMX, ECMODE, ISAM, 
MAXDEV, PMA, REALTIMER, 
STFIRST, SVCACCL, SVCOFF, 
VMSAVE, XMEM, and 370E are VM/SP 
HPO Release 4.2 and 5 options that are not 
supported. COMSRV and VCUNOSHER 
are VM/SP HPO Release 5 options that are 
not supported. On the VIRTUAL 
parameter, VM/XA SP accepts FIXED in 
addition to REAL. 
DEDICATE/NODEDICATE, SVMSTAT, 
QUICKDSP, and TODENABLE are new 
options. CONCEAL is a new option for 
VM/SP HPO Release 4.2 users. 


ACCOUNT ACCOUNT VM/XA SP allows multiple account cards. 


CONSOLE CONSOLE Device types 1052 and 3210 are not 
supported. 
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Table 8 (Page 2 of 3). New and Changed User Directory Control Statements 


Description of Change Introduced by 
| VM/SP HPO VM/XA SP VM/XA SP 
SPECIAL SPECIAL Not all VM/SP HPO device types are 
supported. CTCA requires a user ID in the 
| directory. 
DEDICATE DEDICATE NETWORK, resource, and 3330V are not 
supported. NOASSIGN is a new option. 
LINK LINK No change. | 


MDISK MDISK Not all VM/SP HPO device types are 
supported. 


IUCV IUCV Resource id, a VM/SP HPO Release 5 
option, is not supported. Not all CP system 
| | services are supported. 
ACIGROUP ACIGROUP No change. 
INCLUDE INCLUDE No change. 


SCREEN SCREEN No change. 


AUTOLOG You can AUTOLOG in two ways in 
or VM/XA SP: by using the AUTOLOG or 
XAUTOLOG XAUTOLOG directory control statement or 
by issuing the AUTOLOG or XAUTOLOG 
command. In VM/SP HPO, you cannot 
define AUTOLOG in the directory. 


New in VM/XA SP. 


DASDOPT New in VM/XA SP. 

MACHINE New in VM/XA SP. | 
MINIOPT New in VM/XA SP. One of the MINIOPT 
parameters, MDC, specifies whether a 
minidisk may use cache. The default is to 


use it. In VM/SP HPO, the system default 
is for minidisks not to use cache. 


NAMESAVE New in VM/XA SP. | 
NOPDATA New in VM/XA SP. 


SHARE New in VM/XA SP. 
SPOOLFILE | New in VM/XA SP. 
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Table 8 (Page 3 of 3). New and Changed User Directory Control Statements 


Description of Change Introduced by 
VM/SP HPO VM/XA SP VM/XA SP 


XSTORE In VM/SP HPO, Expanded Storage is used 
by CP and is generated on the SYSPAG or 
SYSXSTOR macro. In VM/XA SP, 
Expanded Storage is used by CP and by 
virtual machines. You use the XSTORE 
directory control statement to dedicate some 
or all of Expanded Storage to a virtual 
machine. 


The following steps describe how to convert the directory and bring it online: 


1. You can use COMPSCAN SAMPEXEC along with COMPSCAN SAMPLIST 
pss to flag control statements that are incompatible. Refer to 

( Appendix A, “Conversion Tools” on page 277 for a complete discussion of the 

use and syntax of COMPSCAN. 


Using the COMPSCAN output as a guide, convert the unsupported directory 
control statements. 


2. Update the label in the directory so it matches the label of your SYSRES pack. 


3. Bring the directory online by issuing the CMS class A, B, or C DIRECTXA 
command. 


( If you have completely converted the directory file so it no longer contains 
VM/SP HPO control statements that are not supported in VM/XA SP, enter: 


directxa spdirect 


If, on the other hand, you still have VM/SP HPO control statements in the 
directory, issue the DIRECTXA command with the MIXED option: 


directxa spdirect (mixed 


When you use the MIXED option, DIRECTXA sends you an error message 
regarding unsupported control statements, but ignores most of them and brings 
( - | the directory online. If you have the VM Directory Maintenance Program 
| (DIRMAINT), you can set up a MIXED= YES option so that DIRMAINT will 
| use the MIXED option when issuing DIRECTXA. 


4. In the empty spaces in the following table, write down the minidisk information 
of the directory source file, the CMS system disk, and the XASRES volume. If 
you have a problem loading ([PLing) VM/XA SP, you will need to know these. 


Number of Cylinders 
DASD Starting Cylinder Allocated Volume Serial Number 


XASRES Volume 
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Putting the VM/XA SP Stand-Alone Dump Utility on Tape or DASD 


Refer to VM/XA SP Planning and Administration for instructions on how to do this. 
If the stand-alone dump utility is on tape, you should know where the tape is. If it 
is on DASD, you should know which volume. 7 


Since VM/XA SP stores dumps in system data files, you cannot transport them from 
your VM/XA SP system to your VM/SP HPO system. If you have a problem and 
want to back off to VM/SP HPO, you will need the stand-alone dump facility to 
examine the problem. 7 a | 


Loading the VM/XA SP Nucleus 


In VM/SP HPO, the maximum virtual machine size you can have is 16Mb. Since 
you have to allow 3Mb of virtual storage for the nucleus, this means that the 
maximum V=R size that you can generate when creating a VM/XA SP nucleus in a 
VM/SP HPO virtual machine is 13Mb. 


If you load the VM/XA SP nucleus to tape rather than spool it to your reader, you 
will not be constrained by the 16Mb virtual machine storage size. 


Refer to VM/XA SP Installation and Service and to the VM/XA SP Program 
Directory for the step-by-step procedures. 


Preparing the CP-Owned DASD 


You must reallocate, but not reformat, your paging and spooling packs, except for 
cylinder 0, which you must reformat. 


There is no stand-alone Format/Allocate program in VM/XA SP as there is in 
VM/SP HPO. Instead, you use a CP or CMS command. In CP, you enter: 
CPFORMAT; in CMS, you enter CPFMTXA. 


In order to use CPFORMAT, your virtual machine must be a System/370 mode 
machine. When CPFORMAT executes, it resets your virtual machine and clears 
virtual storage. This means that, after issuing the CPFORMAT command, you must 
re-IPL any system (such as CMS) that was running in your virtual machine. 


CPFMTXA (a CMS module) provides the same function as CPFORMAT but does 
not reset your virtual machine. You can load the CPFMTXA module from the 
VM/XA SP starter system tape onto your VM/SP HPO system to reformat and 
reallocate DASD for use on your VM/XA SP system. 


The table below compares the VM/SP HPO and VM/XA SP options for allocation 
space. You should not allocate cylinder 0 as TDSK. | : 


Description of Change Introduced by VM/XA 
SP : 


Table 9 (Page 1 of 2). Allocation Options | | 
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Table 9 (Page 2 of 2). Allocation Options 


en waa of Change Introduced by VM/XA 
eee eee HPO | VM/XA SP | SP 


PAGE PAGE In VM/SP HPO, you use the PAGE area only 
for preferred paging; you use TEMP for all 
other paging activity. In VM/XA SP, you use 
PAGE for all paging activity; you use SPOL 
only for the overflow paging. 


PERM PERM No change. 


SPOL In VM/XA SP, you use SPOL for spooling and 
overflow paging activity (and also for dump 
space). 


In VM/XA SP, you use SPOL for dump space 
in addition to spooling and paging activity. 


OVRD Override files are stored as system data files in 
VM/XA SP rather than on DASD. Therefore, 
the OVRD allocation is unsupported. 


TDSK TDSK No change. 
END )END | No change. 


If You Are Building VM/XA SP for the First Time 


As mentioned in the planning chapter, 1t 1s recommended that you build a small, 
one-pack VM/XA SP system first. Then, when you have familiarized yourself with 
VM/XA SP, you can build a larger system. 


SPOL 


When building a one-pack system, ensure that you have the following areas allocated 
on the pack: 


e The directory area | 
¢ A spooling area which, in this case, may be used for paging as well. 


lf You Are Ready to Move Your VM/SP HPO Production to a VM/XA SP 


System | 

If you have tested VM/XA SP and are ready to move your VM/SP HPO production 
to a VM/XA SP system, you may want to use some of the same CP-owned DASD. 
We recommend that you maintain a sufficient number of CP-owned DASDs in 
System/370 mode so that, if necessary, you can quickly back off. However, you may 
want or need to use some of the same DASDs. To do this, you must reallocate, but 
not reformat, your paging and spooling packs, except for cylinder 0, which you must 

reformat. You do not need to reformat cylinder 0 and reallocate DASD that are not 
CP-owned. They can be used in the same format on VM/XA SP. 


Since you cannot reformat and reallocate paging and spooling packs to which you 
are currently attached, you must: 


1. Shut down the system. _ 

2. Re-IPL it with the CP-owned DASD that you plan to reformat offline. 
3. Attach the DASD to a virtual machine. 

4. Reformat cylinder 0 and reallocate. 
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To save time, you may want to write an EXEC that reformats cylinder 0 and 
reallocates the CP-owned DASD for use with VM/XA SP. 


Migrating Spool Files 


You can migrate spool files from your VM/SP HPO system to your VM/XA SP 
system using the CP SPTAPE command. You cannot migrate system files from 
VM/SP HPO to VM/XA SP. The VM/XA SP SPTAPE command ignores such files. 
System files include: 


e Files created by the VM/SP HPO ACNT, CPTRAP, and MONITOR commands 


e VM/XA SP named saved systems, saved segments, image libraries, and UCR 
files 


¢ Virtual machine dumps (output from the VMDUMP command), CP abend 
dumps, and CP stand-alone dumps from either VM/SP HPO or VM/XA SP 


e System trace files. 


In addition, if you move a spool file that originated on a VM/SP HPO system to a 
VM/XA SP system, it loses those file attributes that do not have VM/XA SP 
equivalents. Therefore, if you move the same file back to the VM/SP HPO system, 
it will not be identical to the original file. 


SPTAPE processing in VM/SP HPO Release 4.2 does not provide multivolume tape 
support. This means that you must keep track of the spool files that you are 
dumping to tape. CP will not prompt you to mount another tape when the first tape 
is full. Asa result, you must keep track of the spool files that are being dumped so 
you know where to begin dumping when you start a new tape reel. One way you 
can do this is to write an EXEC that orders the spool files in the system unit record 
devices. Since the spool files are uniquely numbered in the VM/SP HPO 4.2 system, 
you can order the system queue by spoolid, form, or class. (In the VM/XA SP 
system, you cannot order the system queue by spoolid.) Then, when one tape is 
filled during SPTAPE dump processing, you can mount another tape and rerun the 
EXEC, beginning with the last spool file that was reported. 


SPTAPE DUMP processing was enhanced in VM/SP HPO Release 5 to include 
limited multivolume tape support. If all the spool files being dumped cannot fit on a 
single tape, CP prompts you to mount another tape. Once the tape is mounted, 
SPTAPE processing continues. 


VM/XA SP provides the same multivolume tape support as VM/SP HPO Release S. 


Table 10 summarizes SPTAPE multivolume support. 


Table 10 (Page 1 of 2). Summary of SPTAPE Multivolume Support | | | 
Licensed Program SPTAPE Multivolume Support 


VM/SP HPO Release 4.2 No multivolume tape support. The tape runs until 
or VM/XA SP Release 1 the end and then tape processing stops with an 

| error. The partial spool file is erased at the end so 
that there is no problem when loading the files. CP 
does this by backing up the tape and placing a tape 
mark at the end of the last complete file. 
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Table 10 (Page 2 of 2). Summary of SPTAPE Multivolume Support 


Licensed Program SPTAPE Multivolume Support 


VM/SP HPO Release 5 Provides limited multivolume tape support. The 
or VM/XA SP Release 2 tape runs until the end. At the end, CP prompts 
you to mount a new tape. 


Bi geiessll 


The amount of time that SPTAPE processing takes depends directly on the number 
of spool file records in your system. For example, it will take you roughly twice as 
long to SPTAPE dump 50000 records as it will to dump 25000 records. 


To get a rough estimate of how long it will take to dump the spool files in your 
system, do the following: 


1. Measure how long it takes to dump a smail number, such as 1000 records. 
2. Determine how many spool file records you have in the system. 


3. Multiply the number of spool file records in your system by the amount of time 
it takes per record. 


For example, suppose you find that it takes about 80 seconds for you to dump 1000 
records, or .08 seconds per record. Now assume that you have 110000 spool file 
records in your system. By multiplying 110000 by .08, you find that it will take 8800 
seconds, or almost 2-1/2 hours to dump all the spool files in your system. This 
number is not exact, but it gives you an idea of how much time to allot. 


You can decrease the amount of actual time it takes if you attach several tape drives 
and dump spool files from several virtual machines at once. Or you may consider 
dumping spool files over several nights. 


Setting Password Suppression 


In VM/SP HPO, you set and change logon password suppression by using the 
SYSJRL macro during system installation. In VM/XA SP, you set and change 
logon password suppression by using the SET PASSWORD command when the 
system is running, and you query the setting by using the QUERY PASSWORD 
command. 


In VM/SP HPO, you set and change logon password suppression for the LOGON, 
LINK, and AUTOLOG commands as a group. In VM/XA SP, you issue SET 
PASSWORD and QUERY PASSWORD for the LOGON, LINK, and AUTOLOG 
commands individually. 


Re-IMLing the Processor to 370-XA Mode 


Before you IPL VM/XA SP, you must re-IML the processor. 


As mentioned previously, you can use the same IOCP files TOCDS). However, to 
take advantage of the XA architecture, you will most likely want to redefine your 
1/O and recreate IOCP files. | 
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IPLing VM/XA SP with a Cold Start e™ 


What If I Can’t IPL Because of a Problem with the User Directory? | 


You will not be able to IPL VM/XA SP if you did not redirect the user directory for 
VM/XA SP prior to shutting down VM/SP HPO or if there is a problem with the 
VM/XA SP directory. (This may also be the case if you do not update the directory 
after applying service to HCPDIR.) Since VM/XA SP does not support a 
stand-alone directory function, you must do the following: 


1. IPL using the NODIRECT option. This will log on the primary system 
operator. The system operator is authorized to perform all the tasks that he or 
she normally performs, but is not able to link to other virtual machines’ 
minidisks. 


2. Use the DEF MDISK command to obtain access to the minidisks containing the 
directory source file, the CMS system disk, and the XA SYSRES volume. eos 


3. IPL CMS. 2 


4. Issue the ACCESS command to access the minidisk that contains the directory 
source file. 


5. Issue the DIRECTXA command. 
6. Re-IPL the system without the NODIRECT option. 


Refer to VM/XA SP Real System Operation for a complete step-by-step procedure. 
What If I Forgot to Reformat Cylinder 0 and Reallocate CP-Owned Packs? . 


If you forgot to reformat cylinder 0 and reallocate your CP-owned DASD (a DASD 
is CP-owned if the label is defined in the SYSCPVOL list in HCPSYS), you will not 
receive an error message telling you that the DASD 1s formatted or ailocated 
incorrectly. The DASD will be brought up online but will not be CP-owned (even if 
some or all of the DASD is allocated as PERM). 


If you issue a command to attach the DASD, such as: 
CP ATT 453 SYSTEM SPECX5 


You will receive the following error message: 
HCPATS128E DASD 0453 ERROR READING ALLOCATION RECORD 


However, after reformatting cylinder 0 and reallocating the pack, you will be able to 
attach the pack to the system. 


If the DASD is not CP-owned, you do not need to reformat cylinder 0 and 
reallocate. You may use the DASD in the same format as you did on VM/SP HPO. 


Installing the Printer Image Library 


VM/XA SP handles the printer image library differently than VM/SP HPO. See 
Table 11 on page 57. 
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. Table 11. Differences Installing the Printer Image Library 
( | VM/SP HPO VM/XA SP 


You need an image library for 3800 You need an image library for both 
printers. You do not need an image 3800 printers and impact printers. 
library for impact printers. 

After creating or updating image You can create or update image 
libraries, you must re-IPL the system. libraries dynamically under CMS; you 


do not need to re-IPL. 


Uses assemble files: Uses image libraries: IMAGxxxx 
IMG where xxxx is the printer name. 


DMKFCB ASSEMBLE 


DMKUCS ASSEMBLE Sample files are provided on the 
DMKUCB ASSEMBLE product tape for creating image 
DMKUCC ASSEMBLE libraries. You create image libraries 
DMKPIA ASSEMBLE 


7 DMKPIB ASSEMBLE. 
( a 3800 printers using text decks and 


control files 


Impact printers using assemble 
files, text decks, and control files. 


For manipulating image libraries, use 
the GENIMAGE, IMAGELIB, and 
IMAGEMOD commands, and the 
NAME3800 macro. 


For manipulating image libraries, use 
the GENIMAGE, IMAGELIB, 
IMAGEMOD, QUERY IMG, and 
PURGE IMG commands. 


Installing CMS and Other Saved Segments 


| In separate DCSSs or packed in segment spaces, you can install HELP, CMSINST, 
| CMSBAM, CMSDOS, CMSVSAM, and CMSAMS. You can use the SAMPNSS 

| EXEC to define these saved segments. See VM/XA SP Features Summary for the 

| command and EXECs you can use to load and save them, and for a sample layout 
| of CMS virtual storage when all of the CMS saved segments are generated. 


( You should also define a segment to contain EXECs and the System Product Editor. 


Save CMS as a named saved system, in both 370 mode and 370-XA mode, at default 
addresses. 


Back up the CMS named saved systems on tape. Because CP uses system spooling 
space to store named saved systems and because there is always the potential that 
you will not be able to recover spooling space after a CP abnormal termination, you 
should always keep backup copies of named saved systems on tape. The CP 
SPTAPE command enables you to do this. If you IPL VM/XA SP with a cold start, 
named saved systems are not purged. 


Chapter 3. Installation and Service 57 


VM/SP HPO Conversion 


Applying Service to the System rae 


The service procedure used in VM/XA SP is conceptually the same as the procedure ae 
used in VM/SP HPO but is more automated and gives you more control over the | 

changes that are being made. For a complete description of the service procedure, 

read VM/XA SP Installation and Service. A summary of differences follows. 


Differences Applying Corrective Service 
As in VM/SP HPO, you use VMFPLC2 and VMFZAP. The only difference is that 
if you are replacing code (rather than manually updating it) and the code applies to 
the nucleus, you use the patch facility rather than VMFZAP. You continue to use 
VMFZAP for replacing code that does not apply to the nucleus. 


Differences Applying Preventive Service (PUT) 


The procedure is more automated: 


¢ In addition to the source or object code to be updated, 3 you use many files to 
apply PUT service. 


Most of the files used in VM/XA SP are the same as in VM/SP HPO. These 
include PUT document, memo-to-users, control file, auxiliary control files, 
update files, source update files, text decks (these now include prerequisites and 
corequisites for this service), load list, and load map. 


In addition, there are many new or changed files. These include patch update | 
files, update shells, text shells, product parameter file (this replaces the product | 
EXEC), PTF parts list, apply list, exclude list, receive exception log, apply | 
exception log, build exception log, and receive history log. 


* ? 2 
ae, 


e There is a new recommended procedure for how to apply service. In VM/XA 
SP, IBM recommends that you apply service to alternate disks rather than to 
your current system. Once the system is stabilized, you merge the alternate disks 
into your current disks and copy your new system. The alternate disks are then 
free for the next service updates. 


¢ VM/XA SP uses object code service procedures for some modules in CP. 


e New EXECs (actually delivered on the VM/XA SP product tape) replace ie Be 
VMSERYV functions. VMSERYV is retained for compatibility; however, you oe 
cannot use it to apply service to VM/XA SP. You can use VMSERV for other cae 
products, but you should use the VMFREC EXEC instead. 


The new EXECs are VMFREC, VMFAPPLY, and VMFBLD. These EXECs 
require information supplied by a CMS file called the product parameter file. 
This file contains the following: | 


— Control information, such as the name of the main and auxiliary control 
files to be used and the verification functions to be performed while service 
is applied. The name of the user exit EXEC that is called at the end of each 
service function is also supplied in this section. 


— The minidisks to be used for (1) holding source and object code, 
IBM-supplied service files, and user-supplied service files, (2) performing 
updates, and (3) regenerating the nucleus. 


— The EXECs needed to update each part of the component. 


The VMFREC EXEC receives service from the PUT and creates a service XY 
process data base. The VMFREC INFO command maps the PUT and receives 
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the PUT documentation. The VMFREC 5664308 CP or VMFREC 5664308 

a CMS command loads the service files onto the minidisks specified in the product 
( parameter file. Any errors that arise from the VMFREC EXEC are logged in a 
receive exception log on the installer’s A-disk. 


The VMFAPPLY EXEC builds the auxiliary control files that are used to apply 
updates to source and object code. The auxiliary control files are built in 
accordance with the apply list and, optionally, the exclude list for the 
component. The apply list is a list of the program temporary fixes (PTFs) that 
are to be applied to the component. The exclude list is a list of the PTFs that 
are not to be applied to the component, even though they are listed in the apply 
list. 


When invoking the VMFAPPLY EXEC, the installer specifies the number of the 
product (5664308 for VM/XA SP), the name of the component, and the file type 
of the auxiliary control files that are to be built. Options can be specified that 
control whether or not the exclude list is used, errors are logged, and checking is 
performed. 


( The VMFAPPLY EXEC creates or edits the necessary auxiliary control files 
and, if appropriate, invokes the VMFAPNLS EXEC to create auxiliary control 
files for national language support. The new auxiliary control files are used for 
source code files when the source code files are assembled via the VMFHASM 
EXEC. 


After service has been received and applied, and source code files have been 
reassembled, the VMFBLD EXEC is used to generate a new nucleus for the 
specified component. Corequisite and prerequisite checking is done 

( " automatically based on information in the AUX files. 


The method used to apply service depends on whether the code to be serviced 
has been supplied as source code or object code. These methods are used 
automatically by the EXECs already discussed. 


For a complete description of the preventive service procedures, read VM/XA 
SP Installation and Service. 


Differences Building the System 
ae The build process is virtually the same. You continue to use the VMFMAC, 
( | UTILITY, VMFHASM, and CMSGEND EXECs. There are a few differences: 


¢ The VMFBLD EXEC replaces the SPGEN EXEC 
e The dump viewing facility replaces IPCS. 
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Chapter 4. Administration 


Now that you have installed the system, you are faced with the administration task. 
In some cases, you can perform administrative functions in the same manner that 
you did in VM/SP HPO; in other cases, you must completely alter your procedure. 
The following tasks have changed and are discussed in this chapter: 


Managing saved segments 
Restructuring user classes 

Managing system performance 

Setting up the programmable operator 


Setting up service virtual machines. 


Managing Saved Segments 


Using CP Commands to Define Saved Segments 
In VM/XA SP, you manage shared storage while the system is running rather than 


when you generate it. So, instead of using DMKSNT macros, you use commands. 
Use: 


The CP class E DEFSEG command to generate saved segments and create 
segment spaces. It replaces the NAMESYS macro. 


The CP class E SAVESEG command to save the segment and make it active. 


The CP class E QUERY NSS command to determine the characteristics of a 
saved segment. 


The CP class E PURGE NSS command to purge unwanted files that contain 
saved segments. 


The CMS SEGMENT command, SEGMENT macro, or DIAGNOSE code 
X'64' to access the saved segment from a virtual machine. 


Converting DMKSNT Macros to DEFSEG Commands 
Suppose that you have the following entry for the DMKSNT: 


NAMESYS SYSNAME=SFMASSOO 


SYSPGCT=144, 

SYSPGNM=(2128-2271) , 
SYSHRSG=(133,134, 135,136,137 ,138,139,140,141), 
SYSVOL=volid, 

SYSSTRT=(40,07) , 

SYSSIZE=576K, 

VSYSRES=IGNORE 

VSYSADR=IGNORE 
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To translate the information in this entry to definitions for the DEFSEG command, 
follow the steps in this list. It will show you how to obtain the equivalent DEFSEG 
command for the above DMKSNT entry. 


The equivalent command for the preceding entry is: 


DEFSEG SFMASSOO 800-88F SR 


eee ee 


1. Extract the name on the SYSNAME parameter to use as segname on the 
DEFSEG command. This is the name given to the segment. In the DMKSNT 
entry, this is entered as: 


SYSNAME=SFMASS00 


In VM/XA SP, this same segment name is entered as: 
DEFSEG SFMASS00 


2. Convert the decimal value of SYSPGCT to hexadecimal. We recommend that 
you use a hexadecimal calculator or conversion table to make the hexadecimal 
conversions. 


The result tells you how many pages the program needs (in hexadecimal). 


In the example, the result would be X'90', meaning that the program requires 
X'90' (4K) pages of storage. If all pages were in the same segment, the page 
range would be X'0' to X'8F' within the chosen segment. Be sure to count 
PAGE 0 as the first page. In the DMKSNT entry, this is entered as: 


SYSPGCT=144 
In VM/XA SP, X'90', pages are required. The page range may be X'0' to 
X'8F' within the chosen segment. 


3. Divide the decimal value of SYSPGCT by 16. 


The result tells you how many 64K segments the program needs in VM/SP 
HPO. 


In the example, the result would be 9, meaning that the program requires nine 
64K-segments. In the DMKSNT entry: 


SYSPGCT=144 
To convert this for VM/XA SP: 
144 divided by 16 equals 9 


The program needs 9 (64K) segments. This information is used later in the 
DEFSEG command definition. 


4. Convert both decimal values of the SYSPGNM parameter to hexadecimal 
values. 7 


Use the hexadecimal values to define the starting and ending pages and relative 
location of the segment in VM/SP HPO. 


In the example shown, 2128 is X'850'. The hkely place to locate this program 
might be to start it on page X'00' in segment 8. (If you accepted the default 
location of segment 8 for CMSVSAM, this new segment will overlay 
CMSVSAM.) Round down to the nearest segment boundary. The ending page 
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is X'8DF' (X'850' plus X'8F' pages). Count page 0 as the first page. In the 
DMKSNT entry, this is entered as: 


SYSPGNM= (2128-2271) 
Converting the values to be used in VM/XA SP: 
2128 = X'850' 2271 = X'8DF'. 
In VM/XA SP, this is entered as: 
DEFSEG SFMASS0O 800 
(You will use the ending page value later in the DEFSEG command definition.) 


. Look for the SYSHRSG parameter. If present, all the 64K segments listed are 


to be shared by users. The first letter of the mode operand will be S. Count the 
number of segments listed singly or within a segment range. Compare the count 
to the result of SYSPGCT. 


If the count equals the result of SYSPGCT, all storage is shared. When the 
count is less than the result of SYSPGCT, you must figure out which pages and 
how many pages of storage must be put in an exclusive segment or segments. 
The first letter of the mode operand is an E. 


Another way to determine the first letter of the mode operand is to multiply the 
beginning segment number by 16 (the number of pages in a 64K segment) and 
then multiply the ending segment number by 16 and add 15 (pages 0-15 of the 
last segment). Compare the two results to the decimal values for SYSPGNM: 


e When your results are the same as the values in SYSPGNM, all segments 
are shared. 


¢ When your results do not match the values in SYSPGNM, the segments 
outside your results are exclusive. 


In the example, there are nine segments listed as shared; 9 is the result of 
dividing SYSPGCT by 16, so all segments defined for SFMASSO00 will be 
shared. In the DMKSNT entry, this is entered as: 


SYSHRSG= (133 , 134,135,136, 
137 ,138,139,140,141) 


To convert this to be used in VM/XA SP: 


9 segments 
133 x 16 = 2128 
141 x 16 = 2256 + 15 = 2271 


In VM/XA SP, the equivalent statement is: 
DEFSEG SFMASSOO 800-88F Sm 


The ‘m’ in the above example is the second letter of the mode operand (either R, 
E, or N). This will be discussed below. 


If the example had SYSHRSG = (133,134,135,136,137,138), six segments would 
be shared; the remaining three segments would be exclusive and would have to 
be placed in the next 1Mb segment. Each segment of SYSHRSG represents 
X'0' to X'F' pages, so the shared portion would be the first X'60' pages 
(pages X'0' to X'5F') of the lower segment, and X'30' pages would be the 
first pages in the next segment (pages X'0' to X'2F'). The page range might be 
X'800' to X'85F' for shared code and X'900' to X'92F' for the exclusive 
code. In the DMKSNT entry, this is entered as: 


SYSHRSG= (133 ,134,135,136,137,138) 
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To convert this for use in VM/XA SP: 


6 segments 
133 x 16 = 2128 
138 x 16 = 2208 + 15 = 2223 


In VM/XA SP, the equivalent statement is: 
DEFSEG SFMASS00 800-85F Sm 900-92F Em 


6. Look for the PROTECT parameter. When PROTECT =ON or when the 
parameter is missing (the default is ON), the second letter of the mode operand 
will be R (for read-only). When PROTECT = OFF, the second letter of the 
mode operand will be W (for read/write access). All exclusive segments should 
have W as the second letter. In the DMKSNT entry: | 


The PROTECT parameter is missing 


For VM/XA SP, this means that all pages are shared read-only. In VM/XA SP, 
the equivalent statement is: 


DEFSEG SFMASSO® 800-88F SR 


In the preceding example with both shared and exclusive segments, you would 
assign R to the shared segment because there was no PROTECT parameter, but 
W to the exclusive segment. In the DMKSNT entry: 


The PROTECT parameter is missing 
For VM/XA SP, shared pages are read-only and exclusive pages are read/write. 
In VM/XA SP, the equivalent statement is: 
DEFSEG SFMASSO0@ 800-85F SR 900-92F EW | — 
7. Look for the RCVID operand. If present, add the RSTD operand to the ed 
DEFSEG command. When you want to restrict access to the program, you 
might want to add the RSTD operand. You would also want to add the RSTD 
operand when a person will load the segment using DIAGNOSE code X'64' 
with the E function code. Access to a restricted segment requires that the user 
have directory authorization via the NAMESAVE directory statement. If you 
want to restrict access to the program in the example, you would add RSTD to 


the DEFSEG command. Suppose the following were entered in the DMKSNT 
entry: eo 


RCVID=userid aed 
In VM/XA SP, the equivalent statement would be: 
DEFSEG SFMASSO0 800-88F SR RSTD 


8. The following parameters of the DMKSNT entry are not applicable to a 
DEFSEG command in VM/XA SP: SYSVOL, SYSSTRT, SYSSIZE, 
VSYSRES, VSYSADR, SYSCYL, SYSBLOK, USERID, and SAVESEG. 


Saving a CMS File Directory in a Saved Segment 
The procedure for saving a CMS file directory in a saved segment using the CMS 
SAVEFD command is slightly different in VM/XA SP than in VM/SP HPO. 


In VM/SP HPO, the procedure is: 
1. Define the segment in the system through an entry in DMKSNT. 


2. The upper limit of virtual storage of the class E user who is saving the DCSS 
must be lower than the starting address of the segment. Issue the DEFINE 
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STORAGE command with a value that is less than the starting address of the 
( “| | segment location. 


3. Issue IPL CMS. 
4. Issue SAVEFD INIT. 
5. Issue SAVEFD SAVE. 


In VM/XA SP, the procedure 1s: 


|. Define the segment in the system using a DEFSEG command. If the directory is 
in a member saved segment, define all the members of the segment space. 


2. Include a NAMESAVE entry in the directory of the class E user who is saving 
the saved segment. 


3. This user’s virtual storage upper limit must be greater than the ending address of 
the segment location. Issue the DEFINE STORAGE command with a value 
( . that is greater than the ending address of the segment location. 


4. Issue SAVESEG segname. If the directory is in a member saved segment, make 
sure that you save all members of the segment space. 


5. Reissue the DEFSEG command. If the file directory is in a member saved 
segment: 


¢ Redefine the directory to be saved with page ranges 
¢ Redefine the other members with the SAMERANGE operand. 


6. Now the virtual storage of the user who is saving the saved segment must be 
( ‘ lower than the starting address of the segment. Issue the DEFINE STORAGE 

i command with a value that 1s less than the starting address of the segment 
location. 


7. Issue IPL CMS. 
8. Issue SAVEFD INIT. 
9. Issue SAVEFD SAVE. 


a Using Segments in Virtual Machines 
( In VM/SP HPO, a virtual machine user can use a program in a saved segment only 
when the segment is outside his or her address space. For example, a licensed 
program such as PROFS might be loaded into a segment starting at 6 Mb. VM/SP 
HPO CMS users of virtual machines with storage greater than 6 Mb cannot load or 
use PROFS. Users of the virtual machines would risk overlaying their storage. This 
is why the saved segments are called discontigucus. 


In VM/XA SP CMS, a user of any size virtual machine can use programs loaded 
into any saved segment as long as the user defines a “hole” for the program in his or 
her address space. The SEGMENT command and macro instruction make segment 
definition and management possible for virtual machine users and application 
programs. 
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Restructuring User Classes 


In VM/XA SP, as in VM/SP HPO, if you want to give a CP command, DIAGNOSE 
code, or system function a class definition that is different than the IBM-defined 
class, you must create a class override file. | 


The format for the class override file (CMS source file), the syntax of the 
OVERRIDE command, and the way the OVERRIDE command works is different 
in VM/XA SP than in VM/SP HPO. In addition, the internal user class restructure 
file is kept in a system data file in VM/XA SP rather than, as in VM/SP HPO, in the 
OVRD space allocated on the same volume as the directory. System data files reside 
in spool space, but, unlike reader, printer, and punch files that also reside in spool 
space, they are not destroyed by a cold start. 


In addition, there are differences among the individual commands with respect to 

function, invocation, response, and privilege class. Before you convert your VM/SP arn 
HPO class override file to the VM/XA SP class override file, you should review 
“VM/SP HPO and VM/XA SP Command Compatibility” on page 105 for each 
command to verify that the command still exists, that the privilege class is the same, 
and that you still want to override the command in the same manner in VM/XA SP 
as you did in VM/SP HPO. 


Note that Diagnostic CCW commands require class F authority in VM/XA SP. 


The Class Override File for VM/SP HPO 


The class override file consists of one DESTINATION control statement (giving the KO 
location of the CP-owned volume that contains the internal override file) followed by c ; 
an OVERRIDE control statement for each command or DIAGNOSE code whose - 
IBM-defined privilege class is to be overridden. 


VM/SP HPO commands, DIAGNOSE codes, and system functions have an 
IBM-defined type or multiple types. This is what you indicate on the TYPE | 
parameter. Commands, DIAGNOSE codes, and system functions also have a class, 
which you can modify. You assign this using the CLASS parameter. 


Figure 14 is an example of a VM/SP HPO class override file. In the example, notice 
that the CHANGE command has a TYPE=S version and a TYPE=G version. The We? 
TYPE attribute is used to distinguish between the two versions. 


Destination cuu devtype volser 


ACNT TYPE=0 = CLASS=D 
ADSTOP TYPE=G CLASS=IJK 
ATIN TYPE=G  CLASS=IJK 
AUTOLOG TYPE=0 CLASS=FGI 
CHANGE TYPE=S  CLASS=FG 
CHANGE TJTYPE=G = CLASS=IJKL 


Figure 14. Example of a VM/SP HPO Class Override File 
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Note: In VM/SP HPO the first control statement in the class override file is a 
destination control statement. This is not required in VM/XA SP because there are 
no OVRD cylinders. 


The Class Override File for VM/XA SP 
The VM/XA SP class override file consists of an OVERRIDE control statement for 
each command, DIAGNOSE code, or system function whose IBM-defined privilege 
class is to be overridden. It does not have a DESTINATION control statement. 
This is because the VM/XA SP internal user class restructure file is kept in a system 
data file. 


Unlike VM/SP HPO, VM/XA SP commands, DIAGNOSE codes, and system 
functions are not associated with a user’s group function. As a result, there is no 
TYPE attribute. VM/XA SP commands, DIAGNOSE codes, and system functions 
do have an IBM-defined class. You redefine this class using the NEWCLASS 
attribute. Refer to VM/XA SP Planning and Administration for examples. 


Some VM/XA SP commands and system functions have more than one IBM-defined 
user class. To distinguish between the different classes, you must use the 
IBMCLASS attribute. For commands that have only one IBM-defined user class, 
you may use the IBMCLASS attribute, but you are not required to use it. 


Figure 15 is an example of a VM/XA SP class override file. In the example, note 
that the ADSTOP command was deleted because it is not supported in VM/XA SP. 
The ACNT command has only one IBM-defined class; thus, you can code the 
a IBMCLASS attribute but it is not required. The CHANGE command, on the other 
( | hand, has multiple versions; thus, you must code the IBMCLASS attribute to 
: distinguish between the versions. 


* 


ACNT NEWCLASS=D 
i ATTN NEWCLASS=HI IBMCLASS=G 
AUTOLOG NEWCLASS=P IBMCLASS=A 


CHANGE NEWCLASS=EF IBMCLASS=D 
CHANGE NEWCLASS=HI IBMCLASS=G 


Figure 15. Example of a VM/XA SP Class Override File 


Comparison of the VM/SP HPO and VM/XA SP Override Files 
Table 12 (Page | of 2). Comparison of the VM/SP HPO and VM/XA SP Override 


Files 

Equivalent Compatibility Notes 
=| Noeuivalentsatenent 
peewoas | 
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Table 12 (Page 2 of 2). Comparison of the VM/SP HPO and VM/XA SP Override | 
Files 

VM/SP HPO | VM/XA SP | 

Parameter Equivalent Compatibility Notes 


TYPE IBMCLASS IBMCLASS means the IBM-defined user 
class. It is used somewhat differently than 
TYPE. 


| In VM/SP HPO, you use TYPE when the 
command you are overriding has multiple 
privilege classes and when the command 
functions differently between those classes. If 
the command functions the same way between 
all the classes, you do not need to code the 
TYPE operand. 


In VM/XA SP, you must use IBMCLASS —_, 
when the command has multiple privilege — 
classes whether or not the command functions 


differently between those classes. You can 
code only one of these classes on each 
IBMCLASS operand. If the command has 
only one privilege class, you may use 
IBMCLASS, but you are not required to use 
it. 


In VM/XA SP, you use IBMCLASS only to ‘c 
define what is changing from the IBM default. y 
In VM/SP HPO, you use TYPE to indicate 
| both the default and what is changing. 


In VM/SP HPO, TYPE identifies a user’s 
group function: O, R, P, S, A, C, or G. In 
VM/XA SP, IBMCLASS identifies the 
IBM-defined command class: A, B, C, D, E, 
F, or G. 


Comparison of the VM/SP HPO and VM/XA SP OVERRIDE Commands eed 
In VM/SP HPO, the OVERRIDE command is a CMS module. When you issue 
OVERRIDE, the override file is written out to the CP-owned pack where the OVRD 
space is allocated. In order to use OVERRIDE, you must have: 


e Access to the CMS module 
e¢ Write-access to the CP-owned pack where the OVRD space is allocated. 


Like VM/SP HPO, the VM/XA SP OVERRIDE command is a CMS module. 
However, it operates differently. When you issue the VM/XA SP OVERRIDE 
command, DIAGNOSE code X'C4' is invoked. DIAGNOSE code X'C4' writes 
the override file to the system data file. In order to use OVERRIDE, you must 
have: 


¢ Access to the CMS module 
e Privilege class A, B, or C (because these privilege classes have access to 
DIAGNOSE code X'C4'), 
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The basic syntax of the VM/XA SP OVERRIDE command is the same as VM/SP 
( 7 ; HPO, although the options differ. The syntax 1s: 


OVERRIDE fn fm ft [options 


Where filename (fn) filemode (fm) filetype (ft) indicates the class override file. 


Table 13 compares the options: 


Table 13. Comparison of VM/SP HPO and VM/XA SP OVERRIDE Options 


VM/SP HPO | VM/XA SP 
Option Equivalent Compatibility Notes 


EDIT VALIDATE VALIDATE (or the synonym EDIT) 
EDIT provides equivalent function to VM/SP 
HPO’s EDIT option. It verifies that the 
control statements in the class override file 
have the correct syntax. 


CLEAR (or the synonym FREE) provides 
equivalent function to VM/SP HPO’s FREE 
option. It specifies that the command 
privilege classes should return to the 
IBM-defined privilege classes. 


FREE CLEAR 
FREE 


oer DEFER DEFER specifies that the new class structure 
should take effect after the next system IPL. 


This is the default. 


VM/SP HPO does not give you the option of 
DEFER or IMMEDIATE. In all cases in 
VM/SP HPO, the new class structure takes 
place after the next system IPL. 


New in VM/XA SP. IMMEDIATE specifies 
that the new class structure should take 
effect right away. 


IMMEDIATE 


Converting Your VM/SP HPO Class Override File 


To restructure user classes in VM/XA SP, you must: 


1. Create the class override file as shown in Figure 15 on page 67. You may 
decide to modify your VM/SP HPO class override file for your VM/XA SP 
system. In this case, you can use the FILECONV SAMPEXEC and the 
CONVUCR SAMPCMDS files that are provided on the VM/XA SP product 
tape. 


Refer to Appendix A, “Conversion Tools” on page 277 for a complete 
discussion of the FILECONV sample EXEC. 


If you use the FILECONV sample EXEC, you should still look at “VM/SP 
HPO and VM/XA SP Command Compatibility” on page 105 to ensure that you 
want to use the VM/XA SP command in the same manner that you used the 
VM/SP HPO command. 


Once you convert your VM/SP HPO override file, determine whether you want 
to override any new VM/XA SP commands. If so, add these to the file. 
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. Issue the OVERRIDE command with the VALIDATE option to verify the 


syntax of the class override file. In VM/SP HPO the EDIT option had the same fo 
function, and EDIT is an accepted synonym for VALIDATE in VM/XA SP. eo Y 


. Issue the OVERRIDE command with one of these options: 


¢ IMMEDIATE causes your user-defined class structure to take effect 
immediately. 


e DEFER causes your user-defined class structure to take effect at the next 
system IPL. This is the default option for the OVERRIDE command. 


. To reset your class structure to the IBM-defined classes, issue the OVERRIDE 


command with the CLEAR option. This command takes effect at the next 
system IPL. In VM/SP HPO the FREE option had the same function, and 
FREE is an accepted synonym for CLEAR in VM/XA SP. 


. Issue DIRECTXA to redirect the directory. 


Managing System Performance 


The VM/XA SP Scheduler 


a 
Querying or Purging User Class Restructure Files = 
Since VM/XA SP user class restructure files are kept in system data files rather than : 
on CP-owned DASDs, you must handle them differently. 
VM/XA SP provides two commands so you can query and purge user class 
restructure files; QUERY UCR and PURGE UCR. 
Refer to VM/XA SP Planning and Administration for a complete explanation of the 
user class restructure function in VM/XA SP. 
(f * 
Although the VM/XA SP scheduler incorporates some of the same concepts as the 
VM/SP HPO scheduler, it has a completely different design. The following list 
highlights a few of the differences and similarities. To understand how the VM/XA 
SP scheduler works, refer to the VM/XA SP Features Summary. 


¢ Like VM/SP HPO, the VM/XA SP scheduler places users in lists: 


~- The dormant list (does not exist in VM/SP HPO) 

— The eligible list 

— The dispatch list (called the run list in VM/SP HPO) 

— The dispatch vector or run list (called the dispatch list or true run list in 
VM/SP HPO). 


Like VM/SP HPO, the VM/XA SP scheduler classifies virtual machines in 
transaction classes. However, the VM/XA SP scheduler moves users from one 
transaction class to another based on real elapsed time rather than processor 
time. Like VM/SP HPO, the following transaction classes are used: 


E1, QI are users with short-running transactions. 
E2, Q2 are users with medium-running transactions. 
E3, Q3 are users with long-running transactions. 


In addition, the VM/XA SP scheduler classifies some users as E0, QO. These 
users do not wait in the eligible list but go directly into the dispatch list. 
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e Like VM/SP HPO, VM/XA SP uses the concepts of an interactive storage buffer 
aa and interactive bias. In VM/XA SP, these concepts extend not only to storage 
( but also to paging devices and to the multiprogramming level in general. 


VM/XA SP Tuning Commands 


The different scheduler design significantly changes the externals for the CP 
commands that control the way the system allocates resources. 


The VM/XA SP SET SRM command has the following operands: 


e IABIAS specifies the new interactive bias to take effect. The interactive bias 
causes users doing trivial transactions to receive better service than their 
scheduling share would otherwise entitle them to receive. 


e DSPBUF specifies the dispatch buffer to take effect. The dispatch buffer sets a 
limit on the number of users in each transaction class who are allowed in the 
dispatch list. 


( : e DSPSLICE is the new size, in milliseconds, of the dispatching minor time slice. 
; This is the amount of processor time a virtual machine may consume before 
re-examination by the scheduler. 


e LDUBUF partitions the commitment of the system’s paging resources when 
choosing users to move from the eligible list to the dispatch list. The result is a 
mechanism that controls paging capacity based on the transaction class of a 
user. | 


¢ STORBUF partitions the scheduler’s view of main storage when choosing users 
wae to move from the eligible to dispatch lists. The result is a mechanism that 
( | controls use of main storage based on the transaction class of a user. 


Refer to the VM/XA SP CP Command Reference for a complete description of the 
SET SRM command, to the VM/XA SP Features Summary for a discussion of the 
the design and use of the scheduler, and to VM/XA SP Planning and Administration 
for a discussion of tuning controls. 


Because the VM/XA SP scheduler differs from the VM/SP HPO scheduler, there 1s 
| no one-to-one correlation between the tuning commands of the two systems. In 
( some cases, however, the intent or use of commands does correlate. Table 14 
presents VM/SP HPO and VM/XA SP commands that serve a similar purpose. 


Table 14 (Page 1 of 3). Comparative Uses of VM/SP HPO and VM/XA SP Tuning 
Commands | 


If You Use This 
VM/SP HPO 
Command: 


SET PRIORITY 


You Might Consider Using This VM/XA SP Command: 


SET SHARE userid RELATIVE 
(or SHARE RELATIVE directory control statement) 


Although the implementation is different, SHARE 
RELATIVE performs a similar function to SET 
PRIORITY in that it controls the amount of service 
the user receives in comparison to other users. 
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| Table 14 (Page 2 of 3). Comparative Uses of VM/SP HPO and VM/XA SP Tuning 
Commands 


| If You Use This 
VM/SP HPO 
Command: 


SET FAVOR % 


You Might Consider Using This VM/XA SP Command: 


SET SHARE userid ABSOLUTE 
(or SHARE ABSOLUTE directory control statement) 


Although the implementation is different, SHARE 
ABSOLUTE performs a similar function to SET 
FAVOR % in that it controls the amount of resources 
virtual machines receive. As is recommended with the 
SET FAVOR % command in VM/SP HPO, you 
should use SHARE ABSOLUTE with discretion to 
avoid having the total shares exceed 100%. This 
would cause the scheduler t6 attempt to deliver more 
resources than actually exist. 


| SET QUICKDSP 


SET QUICKDSP is like SET FAVOR in that it 
allows the specified virtual machine to bypass the 

| eligible list and go directly into the dispatch list. The 
| SET QUICKDSP user is classified QO. Like the SET 
FAVORed user in VM/SP HPO, the dispatch priority 
is not improved. 


SET FAVOR 


In VM/SP HPO, there is no way to reserve storage for 
the SET FAVORED user and, as a result, storage can 
be overallocated if you use SET FAVOR too often. 

In VM/XA SP, you can use the SET SRM STORBUF 
command to reserve storage for the SET QUICKDSP 
users. 


SET SRM IABIAS - 


SET SRM IB 


Although the implementation is completely different, 

| the intent of the VM/XA SP interactive bias is the 
same as the VM/SP HPO interactive shift bias: to 
give good response time to trivial transactions that 
only require a small fraction of a second of processing 
to complete. 


SET SRM DSPSLICE 


As in VM/SP HPO, the DSPSLICE is the size, in 
milliseconds, of the dispatching minor timeslice. 


SET RESERVED 


As in VM/SP HPO, the VM/XA SP SET RESERVED 
command keeps a specified number of pages resident 
in real storage at all times for a particular user. 


SET SRM DSPSLICE 


SET RESERVE 
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Table 14 (Page 3 of 3). Comparative Uses of VM/SP HPO and VM/XA SP Tuning 
Commands 


If You Use This 
VM/SP HPO 
Command: 


You Might Consider Using This VM/XA SP Command: 
SPMODE DEDICATE : 


If you have a multiprocessor configuration but are 
running in uniprocessor mode, the VM/SP HPO 
SPMODE command allows you to grant the sole use 
of the other processor to the MVS V=R virtual 
machine. The VM/XA SP DEDICATE command is 
similar in that it allows you to grant the sole use of a 
real processor to a virtual machine. 


SET SRM IBUFF SET SRM STORBUF 


Although the implementation is different, the intent of 
the VM/XA SP SET SRM STORBUF command is 
similar to the intent of the VM/SP HPO SET SRM 
IBUFF command: it is used to reserve (or buffer) 
storage for users based on their transaction class. 


In the VM/SP HPO command, you set aside an area 
of storage (called the interactive buffer) to be used by 
interactive users (class 1 and first-time class 2 users) 
only. The remainder is used by all users. You also 
define the time after which an interactive user’s 
working set pages are no longer part of this interactive 
buffer. This means that, after the specified period of 
time, if there are not enough interactive users, VM/SP 
HPO will use the interactive buffer for noninteractive 
users. 


In the VM/XA SP command, you have control over 
the amount of storage that each class of user can use, 
not just the interactive user. You can define an area 
of storage to be used only by class | users, a second 
area to be used only by class | and 2 users, and a 
third area to be used by class 1, 2, and 3 users. If you 
do not allocate 100%, the remainder is used only for 
QO users (SET QUICKDSP users). If there are no QO 
users, the remainder is used to keep pages of dormant 
users. 


Unlike the VM/SP HPO SET SRM IBUFF command, 
you do not define the time after which a user’s 
working set pages are no longer part of the defined 
storage buffer. Thus, CP does not override your 
definitions. This gives you more control but means 
that you must be more careful in how you define the 
storage buffer. Note that this control allows you to 
overcommit or undercommit storage. There is no 
implied top boundary fixed at 100% as in VM/SP 
HPO. In VM/XA SP, the top boundary is set as one 
of the three operands of this command and may be set 
larger or smaller than 100%. 
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The following VM/XA SP commands have no equivalent function in VM/SP HPO: 


SET SRM DSPBUF 7 | f 
SET SRM LDUBUF. ‘ 


Due to the differences in the VM/XA SP scheduler and paging algorithms, the 
following VM/SP HPO commands have no equivalent function in VM/XA SP: 


SET MINWS 

SET PAGING 

SET QDROP OFF 

SET SRM MAXPP 

SET SRM MAXWSS 

SET SRM MINNUMSS 

SET SRM PB 

SET SRM PCI 

SET SRM PGFULL 

SET SRM PGMTLIM 7 
SET SRM PREPAGE a 
SET SRM SWPQTIME (VM/SP HPO Release 4.2 only). ees 


Tuning the VM/XA SP System 7 
Table 15 presents different problems you may face at your installation and the 
appropriate tuning controls (CP commands) that apply to VM/XA SP. For details 
on tuning the VM/XA SP system, refer to VM/XA SP Planning and Administration. 
For the syntax of the VM/XA SP commands, refer to the VM/XA SP CP Command 


Reference. 
The controls for each environment are listed in approximate order of importance oo™ 
although, in some environments, the order of importance is difficult to predict. QW 


Table 15 (Page 1 of 2). Summary of Tuning Controls for VM/XA SP 


Appropriate Tuning Controls for 
Situation VM/XA SP 


Processor-constrained environment 1. UNDEDICATE 


2. SET SRM DSPBUF 
3. SET SRM IABIAS wr 


Storage-constrained environment 1. SET SRM STORBUF ae 
2. SET RESERVED 


Paging-constrained environment 1. SET SRM LDUBUF 
2. SET RESERVED 


I/O-constrained environment . SET SRM DSPBUF 
. SET SRM DSPSLICE 
. SET SRM IABIAS 


Need improved performance for a . SET SHARE 
production guest . VER | 
. SET QUICKDSP 
. SET RESERVED 
. DEDICATE 
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Table 15 (Page 2 of 2). Summary of Tuning Controls for VM/XA SP 


Appropriate Tuning Controls for 
Situation VM/XA SP 


Need improved performance for a service 1. SET QUICKDSP 
virtual machine 2. SET SHARE 

3. V=F 

4. SET SRM STORBUF 
5. SET RESERVED 


Guidelines for Converting Your VM/SP HPO Paging and Swapping 


Convert all the paging and swapping space defined in your VM/SP HPO system to 
paging space. Once you begin to exploit VM/XA SP capability, the load on the 
paging subsystem will increase. At this point, you will need to increase the amount 
of DASD allocated. We recommend that you allocate about two to four times the 
amount of DASD space that is normally in use by all the logged-on virtual machines 
in the system. 


Put CP-owned devices on separate channels from devices used by V=R and V=F 
guests. Put CP-owned devices on separate control units from devices used by V=R 
guests. 


Dedicate the paging devices to VM/XA SP. Do not share the paging devices with 
TDISK or SPOL space. TDISK space should be isolated because it is frequently 
reformatted and could cause contention with paging. Spool space can be intermixed 
but it’s advisable that you separate it. Do not combine paging and spooling unless 
your paging and spooling rates are below 20 pages per second. You can combine 
spooling and minidisk I/O on the same control unit. 


Refer to VM/XA SP Planning and Administration for information and 
recommendations on planning for real and auxiliary storage. 


The VM/XA SP Monitor 


The SYSMON macro, used in VM/SP HPO to specify monitor collection 
parameters, does not exist in VM/XA SP. In VM/XA SP, all collection parameters 
are controlled by the MONITOR command. This eliminates the need for updating 
HCPSYS, reassembling, and re-[PLing the system whenever you want to change 
monitoring parameters. 


The MONITOR command has been expanded in VM/XA SP to allow an increased 
selectivity in monitoring; that is, users or devices can be monitored on an individual 
basis. The data categories for monitoring are called domains rather than classes. 


There are eight data domains: SYSTEM, MONITOR, USER, I/O, SEEKS, 
SCHEDULER, STORAGE, and PROCESSOR. The SYSTEM domain has been 
designed to include enough overall system performance data such that other domains 
do not have to be enabled unless problems are suspected. 


Another difference between the VM/SP HPO and VM/XA SP MONITOR 
commands is in the way that the enable commands work. In VM/SP HPO, each 
successive monitor enable command overrides the previous one. In VM/XA SP, on 
the other hand, each successive monitor enable command builds on the previous 
command. This means that the enabling of data is cumulative in VM/XA SP. 
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The VM/SP HPO MONITOR DISPLAY command is replaced by the VM/XA SP 
QUERY MONITOR command. In addition, VM/XA SP providesa SET ~ 
MONDATA command to control the collection of terminal input/output data for 
security reasons. 7 


Unlike the VM/SP HPO monitor, which places monitor data in a spool file, the 
VM/XA SP monitor places data in a saved segment. You must define and save the 
saved segment before you can start collecting monitor data. Once you save the 
saved segment, a user can load it and issue an IUCV CONNECT to the 
*MONITOR CP system service. The *MONITOR system service will notify the 
virtual machine when there is data to be processed. 


Only one virtual machine can establish a connection to *MONITOR. Once the 
connection is established, the MONITOR START command can be issued by any 
privileged user ID to obtain system performance data. Other parameters of the 
MONITOR command can be issued at any time by any privileged user. 


To establish a MONITOR saved segment and start generation of MONITOR data: 


1. Create a segment for MONITOR using the DEFSEG command. The saved 
segment must be at least 8 pages. 


2. Save the segment for MONITOR using the SAVESEG command. 


3. Access the MONITOR saved segment from a virtua] machine by issuing the 
CMS SEGMENT command, SEGMENT macro, or DIAGNOSE code X'64'. 


4. Establish [UCV communication with *MONITOR. 
5. Issue MONITOR commands to set up and start collecting system monitor data. 
VM/XA SP provides a sample program called MONWRITE which writes the raw 


monitor data to disk or tape. Refer to VM/XA SP CMS Command Reference for a 
discussion of the sample program. 


For more information about the VM/XA SP monitor, see the VM/XA SP Features 
Summary, VM/XA SP Planning and Administration, and VM/XA SP CP 
Programming Services. 


Start Interpretive-Execution Assist Consideration 


For System/370 preferred virtual machines, the start interpretive-execution assist Is 
available only for I/O devices that have virtual addresses less than or equal to hex 
FFF. 


Setting Up the Programmable Operator 


76 


You shouid update the programmable operator routing table and action routines so 
they are sensitive to the changes in the CP interfaces: 


¢ There are command changes. Refer to “VM/SP HPO and VM/XA SP 
Command Compatibility” on page 105. 


e There are message changes. In VM/SP HPO, message numbers have three 
digits; in VM/XA SP, message numbers have four digits. Some messages that 
use only one line in VM/SP HPO use more than one line in VM/XA SP. In 
some cases, multiple VM/SP HPO messages are replaced by one VM/XA SP 
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message. Refer to “VM/SP HPO and VM/XA SP Message Compatibility” on 
page 127 for details. 


The programmable operator works the same way in VM/XA SP as it does in VM/SP 
HPO. 


Setting Up Service Virtual Machines 


Setting Up Virtual Machines for Accounting and Error Recording 
In VM/SP HPO, EREP and accounting data are collected in spool files. In VM/XA 
SP, EREP and accounting data are collected by service virtual machines. Don’t 
forget to clean off the minidisks from time to time. Also, VM/XA SP does not 
support record types 4, 5, and 6 for accounting data. 


Journaling is not supported in VM/XA SP. Similar function is provided by RACF. 


Setting Up a Virtual Machine for CMS Batch 
The VM/XA SP batch machine differs from the VM/SP HPO batch machine in the 
way that it times jobs. 


The VM/SP HPO batch machine limits job execution time based on the virtual 
processor time the job has consumed. Virtual processor time includes only the time 
when the virtual machine is executing. 


The VM/XA SP batch machine limits job execution based on the elapsed time the 
job has consumed. Elapsed time includes all the time since the job was first 
dispatched. This means that it includes both the time when the virtual machine 1s 
executing and when the virtual machine is waiting between time slices. This 
difference comes about through simulation of the MVS/XA STIMER REAL macro 
by the VM/XA SP batch machine. 


Because of the differences, you should increase the BATLIMIT limits for VM/XA 
SP. Leaving the limit the same would effectively cut a job off sooner on VM/XA SP 
than on VM/SP HPO (five seconds of virtual processor time takes longer than five 
seconds of elapsed time unless the virtual machine has the processor 100% of the 
time). 
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Chapter 5. Real System Operation 


Real system operation tasks include bringing up the system, starting and stopping 
the system, running the system (this consists of controlling processors, controlling 
I/O, and managing data files), shutting down the system, and running utility 
programs. 


For conversion from VM/SP HPO, differences in CP externals such as CP 
commands and messages affect real system operations. For example, VM/SP HPO 
uses QUERY PSTOR for Expanded Storage, while VM/XA SP uses QUERY 
XSTORE. 


This chapter summarizes tasks that you may have to do differently in VM/XA SP. 
Refer to VM/XA SP Real System Operation for details on the operating procedures 
and to the VM/XA SP CP Command Reference for the syntax of CP commands. 


Differences Starting the System 


VM/SP HPO provides four kinds of starts: warm, checkpoint, force, and cold. 
These starts can be modified by specifying DRAIN or SHUTDOWN. The VM/SP 
HPO prompt is: | 


Start ((WARM|CKPT|FORCE|COLD) (DRAIN) ) | (SHUTDOWN) 


VM/XA SP provides three kinds of starts: warm, force, and cold. These starts can 
be modified by specifying DRAIN, DISABLE, NODIRECT, or SHUTDOWN. The 
VM/XA SP prompt is: 


Start ((COLD|WARM|FORCE) (DRAIN) (DISABLE) (NODIRECT) ) | (SHUTDOWN) 


When you IPL VM/SP HPO with a WARM start and an error occurs, VM/SP HPO 
sends a message to the operator before going into a wait state, but VM/XA SP goes 
into a wait state without sending a message to the operator. 


Cold starts are the same in both systems. 


In VM/SP HPO, you use a checkpoint start when there are I/O errors or invalid data 
in the warm start area; you use a force start when there are I/O errors or invalid 
data in the checkpoint area. In VM/XA SP, you use a force start in both cases. 


As in VM/SP HPO, you use DRAIN to suspend spooling activity to unit record 
devices and SHUTDOWN to cancel the process of bringing up the system. In 
addition, in VM/XA SP you can use DISABLE to keep displays from being enabled 
and NODIRECT to bring up the system without a user directory. The NODIRECT 
option is provided in VM/XA SP because there is no stand-alone directory program. 
In this case, CP starts the system without trying to access the user directory. Once 
the system is up, you can recover the user directory. 


During initialization, if the same volume ID resides at more than one device address, 
VM/SP HPO varies online the device at the lowest address but VM/XA SP varies 
online the device that is sensed first. In both cases, the devices at the other addresses 
are varied offline. 
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Differences Making Expanded Storage Available 


In VM/SP HPO, you make Expanded Storage (called Paging Storage) available for f 7 
use by CP by allocating an Expanded Storage area on the SYSPAG or the QL 
SYSXSTOR macro. 2 a 


In VM/XA SP, Expanded Storage is available for use by CP automatically. To 
retain some or all of Expanded Storage for CP’s exclusive use, issue the RETAIN 

_XSTORE command. CP uses Expanded Storage for paging and CMS minidisk 
caching. | 


If you do not retain all of it for CP’s exclusive use, you can make the remainder of 
Expanded Storage available for use by virtual machines. You do this by issuing the 
ATTACH XSTORE command. To remove Expanded Storage from a virtual 
machine, issue the DETACH XSTORE command. To dedicate a real Expanded 
Storage partition to a virtual machine, use the XSTORE directory control statement. 


ea cao ee —_ 
Differ ences in Real System Operation Commands ce 


Table 16 lists VM/SP HPO commands that are used in real system operation and 
that have differences in VM/XA SP. Refer to “VM/SP HPO and VM/XA SP 
Command Compatibility” on page 105 for descriptions of the differences. 


Table 16 (Page 1 of 2). VM/SP HPO Real System Operation Commands with 
Differences in VM/XA SP 


Task a 
) _ 
Create accounting records for logged-on users. ‘7 


Attach a device to a user or to the system 


Restart or reposition the current output on a real 
punch or printer. 


ENABLE 


“FLUSH Halt the current output file on a specified real unit 
record device. 


Force a user to log off the system 


Terminate the active channel program on a real 
device. | 
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Table 16 (Page 2 of 2). VM/SP HPO Real System Operation Commands with 
Differences in VM/XA SP | 


ORDER Change the processing order of your spool files. 
PURGE 


QUERY DUMP Display information about devices assigned to 
receive CP abends. 


Purge spool files. 


QUERY FILES 
QUERY MITIME 


Obtain a count of spool files. 


Determine the time interval settings for the missing 
interrupt detector. 


QUERY PROCESSR Display the online processors and find out how CP 


is using them. 


QUERY PSTOR Determine the amount of expanded storage that is 


assigned. 


QUERY raddr Find out a device’s status. 


QUERY RDR or Display information about spool files. 


QUERY PRT or 
QUERY PUN 


QUERY SYSTEM Check the usage of system volumes. 
QUERY UR © Display real addresses of unit record devices. 


se QUERY VECTOR List the Vector Facility users. 
( : USERS 
” REPEAT Repeat printing or punching of the current spool 
output file. 


SET DUMP AUTO 


Set up the system abend dump environment. 


SET LOGMSG Change the system log message. 
SET MITIME Change the time interval for which a device checks 
: missing interrupts. 
( 3 SHUTDOWN Shut down the system. 
. SPTAPE Save to or restore from tape spool files or system 

data files. 

TRANSFER Send or retrieve files from another user’s virtual 
reader, printer, or punch queue. 


VARY OFFLINE Change the availability of processors to the system. 
PROCESSR or VARY 
ONLINE PROCESSR 


VARY ONLINE 
WARNING Warn users of an impending shutdown. 


Vary a device online. 
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Comparison of VM/SP HPO and VM/XA SP Utility Programs 


VM/SP HPO provides more utility programs than VM/XA SP. The table below 


| | compares VM/SP HPO utility programs and the equivalent function in VM/XA SP. 


VM/SP HPO Utility 
Program Equivalent Function in VM/XA SP 


Directory 


Format/Allocate 


There is no stand-alone directory program in VM/XA 
SP. Asa result, you cannot recover the directory 
without a running system. You must bring up the 
VM/XA SP system with the NODIRECT option and 
proceed to recover the directory. 


There is no stand-alone Format/Allocate program in 


| VM/XA SP. You must have a running VM/XA SP 
system to format and allocate DASD in 370-XA mode. 


| Use the CP CPFORMAT command or the CMS 


CPFMTXA command. 


As in VM/SP HPO there is a stand-alone dump utility 
program in VM/XA SP. If CP is unable to create an 
abend dump, this program allows you to dump all of 


| the VM/XA SP system. 


DASD dump restore 


Device Support 
Facilities 


Miscellaneous Operational Differences between VM/SP HPO and 
VM/XA SP 


The processor alarm sounds more often with VM/XA SP than with VM/SP HPO. 
For example, when you shut down the system and it goes into a wait state, the alarm 


sounds. 


VM/XA SP records soft and hard CP abend dumps. A soft abend dump is always 
written to a system data file. You define the recipient user ID of the system data file 


VM/XA SP provides two versions of the DASD dump 
restore program: 


¢ One version, DDRXA, is a stand-alone program 
that can be run either on a real 370-XA processor 
or in a 370-XA virtual machine 
The other version, the System/370 DDR program, 
is a CMS facility that can be run only under CMS 
in a System/370 virtual machine. 


In most cases, you can use either DDRXA or 
System/370 DDR. There are certain situations, 
however, when you must use a particular version. 
Refer to VM/XA SP Real System Operation for more 
details. 


VM/XA SP supports the Device Support Facilities 
program. 


at system generation time. A hard abend dump is written to printer, tape, or 
DASD. You define the dump device using the SET DUMP command. 
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Message Compatibility 
See “VM/SP HPO and VM/XA SP Message Compatibility” on page 127. 
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Chapter 6. Virtual Machine Operation 


Virtual machine operation tasks include those tasks that allow you to run operating 
systems in virtual machines. 


For conversion from VM/SP HPO, differences in CP externals such as CP 
commands and messages affect virtual machine operations. For instance, the 
ATTACH command in VM/XA SP differs from the ATTACH command in VM/SP 
HPO. 


Changes to CMS may change virtual machine operations. For instance, a user must 
load one CMS named saved system for System/370 mode and another for 370-XA 
mode. 


This chapter summarizes tasks that you may have to perform differently in VM/XA 
( -_ SP. Refer to VM/XA SP Virtual Machine Operation for information on virtual 
eS machine tasks and to VM/XA SP CP Command Reference for syntax of CP 
commands. 


Differences Logging On 


| In VM/SP HPO Release 4.2, you must clear the logo on a 3270-type terminal before 
| entering your user ID (and password) or a command. 


a | In VM/SP HPO Release 5, you can enter your user ID, password, and a command 
( | | on the logo panel on a 3270-type terminal when the logo panel fits entirely on one 
| screen. If the logo panel does not fit, you must first press ENTER. 
| In VM/XA SP, you enter your user ID on the logo panel on a 3270-type terminal 
| unless the terminal is connected to VTAM, in which case you must press ENTER 

| first. You then enter your password on the next panel. 


| The VM/XA SP logo 1s different from the VM/SP HPO logo. 


( The VM/SP HPO response has three digits for the number of users and three 
LK characters for the device address. The VM/XA SP response has five digits for the 
number of users and five characters for the device address. 


| If you enter incorrect information on the logo screen, in VM/SP HPO you receive a 
| prompting message, but in VM/XA SP you receive an error message. 


Differences in Virtual Machine Operation Commands 


Table 17 on page 86 lists VM/SP HPO commands that are used in virtual machine 
operation and that have differences in VM/XA SP. Refer to “VM/SP HPO and 
VM/XA SP Command Compatibility” on page 105 for descriptions of the 
differences. 
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Table 17 (Page 1 of 2). VM/SP HPO Virtual Machine Operation Commands with 
| _ Differences in VM/XA SP 


VM/SP HPO Command | Task 


ADSTOP ; Halt the execution of a virtual machine at a virtual 
instruction address. 

BEGIN Resume execution. 

CLOSE Terminate spooling activity. 

COMMANDS or Display the commands and DIAGNOSE codes that 

QUERY COMMANDS you are authorized to use. | 

DEFINE Define devices for your virtual machine. 

DEFINE CTCA Couple two virtual machines. 


DEFINE STORAGE Define virtual storage size. 
DETACH CTCA Detach a virtual channel-to-channel adapter. 


DETACH vdev Detach a DASD, minidisk, or temporary disk from 
your virtual machine. 

DIAL | Dial 3270 displays. 

DISCONNECT Disconnect from the system. 


DISPLAY Display virtual machine components. 


DISPLAY Display or dump virtual machine registers. 


REGISTERS or DUMP 
REGISTERS 


DISPLAY VECTOR Display Vector Facility registers. 


Dump virtual machine components. 

Dump Vector Facility registers. 

Simulate an external interrupt. 

Load (IPL) your operating system. 

Link to other users’ minidisks. 

Send a message. 

Change the processing order of your spool files. 
Trace program events. 


PURGE Purge spool files. 
QUERY FILES Obtain a count of your spool files. 
QUERY NAMES Display the user IDs of others logged on. 


QUERY RDR or Display information about your spool files. 
QUERY PRT or | 
QUERY PUN 


QUERY SET _ Check your virtual machine’s architecture mode. 
QUERY TRAP Display information about a trace trap. 


QUERY USERS Display the number of logged-on users. 
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Table 17 (Page 2 of 2). VM/SP HPO Virtual Machine Operation Commands with 
Differences in VM/XA SP 


QUERY VIRTUAL Check the device type of a virtual console. 
CONSOLE | 
QUERY VIRTUAL Display the status of a virtual device. 
DEVICE 
QUERY VIRTUAL Check virtual storage size. 
STORAGE 
QUERY VIRTUAL Determine if unit record devices are spooled. 
UR 


SET CONCEAL Activate and deactivate the protected application 
environment. 


|STORE Store data into virtual machine storage. 
STORE REGISTERS Store data into virtual machine registers. 


Define console characteristics. 
Trace system interrupts. 


Message Compatibility 
| See “VM/SP HPO and VM/XA SP Message Compatibility” on page 127. 
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Chapter 7. Application End Use 


Application end use tasks include logging on to the system, running applications, 
and responding to system messages. 


Differences exist between VM/SP HPO and VM/XA SP CP externals. Some CP 
commands have command response differences. For instance, VM/XA SP has a 
different screen logo and slightly different log on procedures. 


Differences Logging On 


See “Differences Logging On” on page 85. 


Differences in Application End Use Commands 


Table 18 lists VM/SP HPO commands that are used in application end use and that 
have differences in VM/XA SP. Refer to “VM/SP HPO and VM/XA SP Command 
Compatibility” on page 105 for descriptions of the differences. 


Table 18. VM/SP HPO Application End Use Commands with Differences in VM/XA 
SP 


Include comments on your console sheet or your 
display screen 


DISCONNECT Disconnect from the system. 
IPL Load (IPL) your operating system. 


LOGOFF or LOGOUT | Log off 
QUERY NAMES Display the user IDs of others logged on. 


QUERY RDR or Display information about your spool files. 
QUERY PRT or 
QUERY PUN 


Message Compatibility 
See “VM/SP HPO and VM/XA SP Message Compatibility” on page 127. 
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Chapter 8. Application Programming 


Application programming tasks include program development and program 
debugging. 


Architecture Differences 


| 

| The CMS component of VM/XA SP has an interface to both System/370 

| architecture and 370-XA architecture. When CMS runs in a System/370 virtual 

| machine, it provides an interface to System/370 architecture. When CMS runs in a 
| 370-XA virtual machine, it provides an interface to 370-XA architecture. 


| The major architectural differences are: 


c~ | ¢ Program status words for each architecture are different. 
( | | e Addressing increases from 24 bits for System/370 to 31 bits for 370-XA. 
| e 1/O handling for each architecture has unique instructions and routing abilities. 
| ¢ There are new and changed assembler language instructions for 370-XA. 


| For more information, see VM/XA SP CMS Application Program Development 
| Guide. 


Summary of Compatibility 


( | The CMS component of VM/XA SP is, in general, upwardly compatible with the 
CMS component in VM/SP HPO Release 5. Except for the DEBUG command and 
other items discussed below, all VM/XA SP CMS commands are compatible. There 
are new CMS commands that invoke new function and there are enhanced 
commands to invoke enhanced function. The enhanced commands are upwardly 
compatible. CMS macros in VM/XA SP are upwardly compatible and CMS 
external control blocks are compatible. 


7 In general, if your application program uses standard CMS interfaces (for example, 
( if it does not manipulate PSWs or depend on CMS internal control blocks) and does 
. not depend on CP command and DIAGNOSE code invocations or responses, you 

may need to recompile or reassemble the program before running it on CMS in 
System/370 mode. For higher-level languages that VM/XA SP supports, programs 
are source and object code compatible. 


Conversion Stages 


While the conversion effort varies from installation to installation, there are three 
basic stages, or levels, of conversion to VM/XA SP CMS: 


Virtual 

Machine Addressing 
Stage Mode Mode Conversion Effort 
System /370 System/370 24-bit Least effort. Your application 
compatibility | programs run as they do now, but 


they run only in System/370 mode. 
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Stage 


370-XA 
toleration 


370-XA 


exploitation 


errcecenemes eerneememnnenarrmaaene 


Virtual 
Machine 
Mode 


370-XA 


370-XA 


Addressing 
Mode 


24-bit — 


31-bit 


Conversion Effort 


More effort because of 
architectural differences between 
System/370 and 370-XA (such as 
PSWs, assembler instructions, and 
I/O). However, your programs | 
cannot support 31-bit addressing. 


Most effort. Like 370-XA 
toleration, 370-XA exploitation 
requires you to adapt your 
programs to 370-XA architecture. 
In addition, your programs can 
support 31-bit addressing. 


Note: When converting your CMS application programs, IBM encourages you to 
bypass the System/370 compatibility stage and go directly to the 370-XA toleration 
stage or, if possible, to the 370-XA exploitation stage. However, before you accept 
this as your plan, consider that all your regularly used programs should run in the 
same virtual machine mode (that is, 370-XA mode) so that users do not have to 
re-IPL CMS when going from program to program. 


The primary reasons for the IBM recommendation to convert directly to 370-XA 
toleration or, if possible, to 370-XA exploitation are: 


e The more conversions you perform, the more time and effort you will probably 
spend. Converting three times (to System/370 compatibility, then to 370-XA 
toleration, and then to 370-XA exploitation) will probably require more time 
and effort than converting once (directly to 370-XA exploitation). 


¢ CMS supports bimodal addressing. This allows programs running in 370-XA 
mode virtual machines to execute in 24-bit addressing mode, 31-bit addressing 
mode, or a combination of both. Therefore: 


— The same CMS used to run programs under 370-XA toleration can be used 
to run programs under 370-XA exploitation. 


— 370-XA toleration allows programs that require 24-bit addressing to run 
using a 370-XA mode virtual machine rather than a System/370 mode 
virtual machine. Therefore, end users need not be inconvenienced by having 
to know which mode their applications require (System/370 mode or 370-XA 
mode), and they do not have to re-[PL CMS when going back and forth 
between System/370 mode and 370-XA mode to accomplish their work. 


See VM/XA SP CMS Application Program Conversion Guide for details about 
bimodal addressing. 


e 370-XA exploitation allows you to move programs above the 16Mb line so that 
you can optimize the use of storage below the line. This is especially helpful for 
programs that require more addressing capability and storage than 24-bit 
addressing allows. 


¢ To relieve real storage constraints, CMS programs can use shared segments to 
share code and data. To relieve virtual storage constraints, CMS programs in 
discontiguous saved segments (DCSSs) can exploit extended addressing. 
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An application program or licensed program in the 370-XA exploitation stage, 
as long as it satisfies all criteria for DCSS candidacy, can be put into a DCSS 
above the 16Mb line. This frees an equivalent space below the line for private 
code. 


An application program or licensed program in the 370-XA toleration stage, as 
long as it satisfies all criteria for DCSS candidacy, can be put into a DCSS 
below the 16Mb line but within the address range of a larger 370-XA mode 
virtual machine, callable from an application program or licensed program 
running under 370-XA exploitation. 


Certain kinds of programs need not be converted. They may continue to run in 
System/370 mode in a processor that is capable of 370-XA mode. Such 
programs include: 


— Programs that run in server machines but that have 370-XA mode 
application interfaces 

— Programs that serve a single user 

-- Programs with a limited purpose, such as system setup. 


Programs that cannot run under 370-XA exploitation should, at a minimum, run 
under 370-XA toleration to facilitate program calling and exchange of data 
addresses within the same CMS virtual machine. These programs should be > 
written in such a way as to isolate them from the underlying architecture. 


If you do not convert directly to 370-XA mode, and you have some programs that 
run in System/370 mode and some that run in 370-XA mode, you can simplify mode 
changing by wnting EXECs. Each EXEC would change the virtual machine mode 
prior to invoking an application program. 


Conversion Checklist 


Commands. 


There may be incompatibilities between VM/SP HPO and VM/XA SP CP 
commands that your program uses. To help you determine differences, IBM 
provides a sample EXEC called COMPSCAN SAMPEXEC, which flags 
commands and other keywords that might need to be changed. See 

Appendix A, “Conversion Tools” on page 277 for more information about 
COMPSCAN. See “VM/SP HPO and VM/XA SP Command Compatibility” on 
page 105 for command comparisons. 


DIAGNOSE codes. 


There may be incompatibilities between VM/SP HPO and VM/XA SP 
DIAGNOSE codes that your program uses. For instance, if your application 
program uses DIAGNOSE X'00' to determine the release level of CP, you must 
examine the program’s use of the licensed program bit map and change it, if 
necessary, to recognize VM/XA SP. You can use the sample EXEC 
COMPSCAN SAMPEXEC to determine differences. See 

Appendix A, “Conversion Tools” on page 277 for more information about 
COMPSCAN. See “VM/SP HPO and VM/XA SP DIAGNOSE Code 
Compatibility” on page 124 for DIAGNOSE code comparisons. 
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Messages and return codes. 


There may be incompatibilities between VM/SP HPO and VM/XA SP messages 
and return codes that your program uses: 


— VM/XA SP has four-digit message numbers; therefore, some command 
invocations now result in four-digit return codes. You should examine 
applications that depend on 10-character message header lengths or 
three-digit control program command return codes. Systems using 
programmed operator facilities must examine their routing tables for any 
changes necessary. | 


— Action indicators on VM/XA SP CP messages may not be the same as the 
corresponding message in VM/SP HPO, even though the message number 
may be the same. | 


— The nonzero return code and accompanying message that VM/XA SP 
returns for errors may not be the same as the nonzero return code that 
VM/SP HPO returns for corresponding errors. | ae 


See “VM/SP HPO and VM/XA SP Message Compatibility” on page 127 for ee 
message comparisons. 


You might consider modularizing calls to CP interfaces to ease migrations to 
future releases of VM/XA SP. 


Privilege classes for some VM/XA SP CP commands and DIAGNOSE codes 
may not be the same as the corresponding CP commands in VM/SP HPO. 


Some CMS applications rely on CP support that is not provided in VM/XA SP. 
For example, VM/XA SP does not support the transparent services access ra 
facility (TSAF). Ly 


VM/XA SP supports DOS simulation in a System/370 mode virtual machine 
only. 


VM/XA SP supports VSE/VSAM functions supplied by the VM/SP Release 5 
CMS in a System/370 mode virtual machine only. 


VM/XA SP supports the EDIT command in a System/370 mode virtual machine 
only. The system product editor (XEDIT) runs in System/370 mode and in 
370-XA mode with 24-bit addressing. fo N 


Programs that are architecture-specific (for example, programs that manipulate ol 
PSWs or issue I/O assembler instructions) require modifications to execute in 

CMS 370-XA mode virtual machines. The applications should continue to 

execute in CMS System/370 mode virtual machines. 


The improved usability that the VM/XA SP implementation of saved segments 
provides may cause some differences in the installation procedures for licensed 
programs. 


VM/XA SP does not support EXECs and editor macros in a saved segment 
above the 16Mb line. EXEC, EXEC 2, and REXX programs may reside only 
below the 16Mb line. 


Particularly sensitive to the conversion are programs that “steal PSWs” or field 
external interrupts. 


In VM/XA SP, leading zeros are suppressed more often than in VM/SP HPO. 


Your program should adhere to the CMS programming interface. The CMS 
programming interface is divided into three groups: the preferred interface 
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group, the CMS compatibility group, and the OS/MVS and DOS/VSE group. 
For more information, see the VM/XA SP CMS Application Program Conversion 
Guide. 


CMS must be [PLed in either System/370 mode or 370-XA mode. You can 
write dual-path application programs and EXECs, which follow one path for 
System/370 mode and a different path for 370-XA mode, or you can write a 
different version for each architecture. In the latter case you should give both 
versions the same name to minimize end-user confusion. You can do this with 
the NUCXLOAD command of CMS, using the form NUCXLOAD name fn, 
where name is the same in both environments and fn is the unique System/370 or 
370-XA version. : 


For additional conversion checklists, see VM/XA SP CMS Application Program 
Conversion Guide. 
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Chapter 9. Diagnosis 


Diagnosis tasks include isolating, describing, reporting, and correcting failures in the 
VM/XA SP and guest operating systems. 


For conversion from VM/SP HPO, differences in CP externals such as CP 
commands and messages affect diagnosis tasks. For instance, VM/XA SP uses the 
SET CPTRACE command rather than CPTRAP for specifying which trace entries 
are to be recorded in the system trace tables. 


VM/XA SP uses the dump viewing facility rather than IPCS for viewing dumps. 
There are differences in the naming of dumps and in symptom record handling for — 
non-CP dumps. 


The Error Recording Facility 


As in VM/SP HPO, VM/XA SP CP error recovery modules create EREP records 
when I/O and machine errors occur. But unlike VM/SP HPO, you use the CMS 
CPEREPXA command (not the CMS CPEREP command) to format and print the 
EREP record (kept in a CMS file). 


In VM/XA SP, you can use the RECORDING command to change processing 
parameters that control the recording of EREP records. 


An operating system executing in a virtual machine can either use its own error 
recording facilities or have CP handle error recording. Use the VM/XA SP SET 
SVC76 command to specify which one. 


VM/XA SP does not provide the *LOGREC system service. 


The Dump Viewing Facility 


The dump viewing facility is a component of VM/XA SP that runs under CMS in 
System/370 mode. Using the dump viewing facility, you can: 


e Interactively display dump data from CP abend dumps, CP stand-alone dumps, 
and virtual machine dumps (especially CMS, GCS, VM/Pass-Through, 
RSCSNET, and RSCSV2 virtual machine dumps). 


e Format and print summary information from CP abend dumps, CP stand-alone 
dumps, and virtual machine dumps. 


¢ Process CP trace table data stored on tape, or process CP trace table data, data 
trace data, I/O trace data, and guest trace data stored in system trace files. 
Specifically, you can: 


— Load CP trace table data from tape or DASD 

— Load data trace, I/O trace, and guest trace data from DASD 

— View and format CP trace table data 

— View and format data trace, I/O trace, and guest trace data 

— Merge CP trace table, data trace, I/O trace, and guest trace data 
— Print CP trace table, data trace, I/O trace, or guest trace data. 


The dump viewing facility does not support the problem reporting and management 
function found in IPCS. 
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Comparison of IPCS and Dump de Facility eee, Oo 
* 


IPCS T Dump Viewing 

Command Facility Command | Differences 

APAR The dump viewing facility does not 
support problem reporting and 
management. 


DUMPSCAN | DUMPSCAN— The syntax is different, the dump viewing 
facility uses the XEDIT interface for 
display management, and some of the 
subcommands have functional 
differences. See Table 20 on page 99 for 
subcommand differences. ! 

IPCSDUMP The dump viewing facility does not see 
support problem reporting and ‘a 
management. However, the CMS Sy He 
DUMPLOAD command has some of the 3 
functions of IPCSDUMP. | 


| The dump viewing facility does not 
support problem reporting and 
management. 


The dump viewing facility does not | a 
support problem reporting and LY 
management. - 


STAT The dump viewing facility does not 
support problem reporting and 
management. 


ADDMAP Use this command to append the 
compressed module map to the CMS file a 
containing the dump processed by the Lo, 
CMS DUMPLOAD command. 
TRACERED This dump viewing facility command 1s 
an equivalent of the VM/SP HPO 
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Comparison of IPCS and Dump Viewing Facility DUMPSCAN Subcommands 


| 
j = | 
( | Table 20 (Page | of 3). Comparison of IPCS and Dump Viewing Facility 
| DUMPSCAN Subcommands 


Dump 
Viewing 


| 
| 
| IPCS Facility 
| DUMPSCAN | DUMPSCAN 
| Subcommand Subcommand Differences 
Null line 
| 2 ? The dump viewing facility ? subcommand ts 
| not limited to displaying the last 
| DUMPSCAN subcommand executed, but 
| displays the last command or subcommand 
| executed of any type, DUMPSCAN or not. 
( 
| AREGS ae Not supported by the dump viewing facility. 
| ARIOBLOK hae Not supported by the dump viewing facility. 
| C CREGS The dump viewing facility supports CP, 
| stand-alone, and virtual machine dumps, and 
| allows you to specify a processor address. 
oo | CHAIN CHAIN The syntax is different and the dump viewing 
( | | facility has more functions. 
| CMS CMS The dump viewing facility can execute CMS 
| commands from the DUMPSCAN command 
| | line. 
CMSPOINT CMSPOINT 
CORTABLE FRAMETBL 


The dump viewing facility has enhanced 
capabilities for invocation and displaying by 
frame table address. 


The dump viewing facility has enhanced 
offset and indirect addressing displays, but 
does not display previous lines. 


. CeND | END[ Noe 
| : FDISPLAY pme | Not supported by the dump viewing facility. 


| GREGS The dump viewing facility lets you specify a 
| processor address. 


The dump viewing facility does not give help 
for messages. 


None. 
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Table 20 (Page 2 of 3). Comparison of IPCS and Dump Viewing Facility 
DUMPSCAN Subcommands — 


Dump 
Viewing 
IPCS Facility 
DUMPSCAN DUMPSCAN 
Subcommand | Subcommand Differences 


LOCATE LOCATE 
(UP) (UP) | 
MAPA FINDMOD FINDMOD combines the functions of 
| 3 MAPA and MAPN. 
MAPN FINDMOD FINDMOD combines the functions of 
| MAPA and MAPN. | 


MREGS — | Not supported by the dump viewing facility. | 
MRIOBLOK ame | Not supported by the dump viewing facility. 


OSPOINT OSPOINT 
PRINT PRINT | None. | 
QUIT | QUIT None. 

REGS REGS The dump viewing facility lets you specify a 
processor address, and displays control and 
floating-point registers for virtual machine 
dumps. 


RIOBLOK RIOBLOK The dump viewing facility RIOBLOK 
subcommand may be invoked with logical 
device or real device addresses in addition to 
device numbers. 


FORWARD FORWARD does not have operands and can | 
be used with FINDMOD and LOCATE. 


SCROLL 


SCROLL U BACKWARD | BACKWARD does not have operands and 
can be used with FINDMOD and LOCATE. 


SYMP SYMPTOM The dump viewing facility does not support 
symptom string extraction for virtual 


machine dumps. 


TLOADL TLOADL 
TRACE TRACE 


The dump viewing facility TRACE 
subcommand merges trace tables from 
multiple processors, does not support the 
SCROLL and SCROLLU operands, and is 
not supported for VM dumps. 


TSAB 
USERMAP 


TSAB 


Not supported by the dump viewing facility. 
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Table 20 (Page 3 of 3). Comparison of IPCS and Dump Viewing Facility 
DUMPSCAN Subcommands 


Dump 


Viewing 

IPCS Facility 

DUMPSCAN DUMPSCAN 

Subcommand Subcommand Differences 

VIOBLOK VIOBLOK The dump viewing facility VIOBLOK 
subcommand may be invoked with virtual 
subchannel or virtual device addresses in 
addition to virtual device numbers. 

VMBLOK The dump viewing facility does not have the 


SYSSPOOL operand, and VMDBK may be 
invoked with storage addresses or individual 
VMDBK fields. 


VMLOADL VMLOADL None. 


Senna BLOCK This subcommand formats control blocks 
within a dump. 


CPU This subcommand displays the processor 
address and the prefix register value for each 


processor in the dump. 

------ SCAN This subcommand processes a PF key 
assignment or a command siring from the 
system product interpreter. 


This subcommand determines the CP module 
flow for a hung virtual machine. 


seates SELECT This subcommand selects trace table entries 
for display. 


This subcommand displays a summary 
snaplist in a soft abend dump. 


------ SNAPLIST 


fous VREG 


------ VPAIR 
information about the Vector Facility for any 


| aa VSTAT 

processor in a virtual machine dump. 
Peeters XEDIT This subcommand causes the dump viewing 
| facility to pass the command line to XEDIT 
| for execution. 
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dump. 
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Dump Processing in VM/XA SP 


VM/XA SP records soft and hard CP abend dumps: 


e A soft abend dump is always written to a soft abend dump file on the reader 
queue. You define the recipient user ID of the soft abend dump file during 
system generation. 


¢ A hard abend dump is written to printer, tape, or DASD. You define the dump 
device using the SET DUMP command. 


In VM/XA SP, dumps include a control block identifier. 


In VM/XA SP, you can use the CMS DUMPLOAD command to load a dump into 


_aCMS dump file for use by the dump viewing facility, and to print a dump from a 


CMS dump file in the same format as a system abend dump. 


Requirements for Dump Space | 


When VM/XA SP writes hard abend dumps to DASD, it requires contiguous space. 
You should be aware that the larger storage sizes in VM/XA SP require more space. 
You might consider dedicating a tape drive as the dump device so you do not need 
contiguous space on DASD. 


VM/XA SP Stand-Alone Dump Utility 


VM/XA SP provides a stand-alone dump utility program. You should store this 
program on tape or DASD. If the stand-alone dump utility is on tape, you should 
know where the tape is. If it is on DASD, you should know which volume. 


Since VM/XA SP stores dumps in system data files, you cannot transport dumps 
from your VM/XA SP system to your VM/SP HPO system. If you have a problem 
and want to back off to VM/SP HPO, you will need the stand-alone dump facility to 
examine the problem. 


VM/XA SP CP Trace Tables 


The number and type of trace table entries differs in VM/XA SP. 


For soft abend dumps, the dump contains the trace tables for the failing processor. 
For hard abend dumps, the dump contains the CP trace tables of all processors. 


VM/XA SP CP trace events are time-stamped to allow comparison of events 
happening currently on more than one processor. TRSAVE sends data to a system 
data file or to tape rather than to a CPTRAP spool file as in VM/SP HPO. 


Differences in Diagnosis Commands 


Table 21 on page 103 lists VM/SP HPO commands that are used in diagnosis and 
that have differences in VM/XA SP. Refer to “VM/SP HPO and VM/XA SP 
Command Compatibility” on page 105 for descriptions of the differences. 
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Table 21. VM/SP HPO Diagnosis Commands with Differences in VM/XA SP : 
CPTRAP | Collect information for problem determination. 


DCP Display the contents of real storage locations at the 
terminal. 

DMCP Print the contents of real storage locations on your 
virtual spooled printer. 

LOCATE Display the address of CP control blocks or of a 
module. 

SET MODE Set the error recording mode for system recovery 
(soft) machine checks. 


STCP Change the contents of real storage. 


TRAPRED Access the CPTRAP file. 
VMDUMP Dump pages of your virtual machine’s storage. 


Message Compatibility 
See “VM/SP HPO and VM/XA SP Message Compatibility” on page 127. 
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Chapter 10. VM/SP HPO and VM/XA SP Compatibility Tables 


This chapter summarizes compatibility information for CP commands, DIAGNOSE 
codes, and messages. 


VM/SP HPO and VM/XA SP Command Compatibility 


Table 22 contains compatibility information for VM/SP HPO commands. The 
compatibility categories are: 


¢ Compatible with VM/XA SP. The command exists in both systems and has 
equivalent syntax, responses, and functions. 


¢ Upwardly compatible with VM/XA SP. The command exists in both systems but 
there are differences in syntax, responses, or functions. Invocations and 
ae applications using the VM/SP HPO command syntax should continue to execute 
( : unchanged. 


¢ Incompatible with VM/XA SP. The command exists in both systems but 
differences in syntax, responses, or functions may cause some invocations or 


applications using the previous syntax to execute incorrectly or not to execute at 
all. 


If you see “----” in a column, that means a corresponding command is nonexistent. 
c. Table 22 (Page 1 of 20). VM/SP HPO and VM/XA SP Command Compatibility 
( VM/SP HPO Corresponding VM/XA 
Commands and Privilege SP Commands and 
Classes Privilege Classes Notes 
sf . Upwardly compatible. VM/XA SP does not 
(Any) (Any) require a blank after the * and does not allow 


the privilege class to be changed. 


#CP #CP Compatible. 
(Any) (Any) 


( - ACNT ACNT 
, (A) (A) 


Incompatible. VM/XA SP ACNT accepts but 
ignores CLOSE if specified, supports a SYSTEM 
operand, and does not send a response that 
accounting has been done. | 


ADSTOP ADSTOP is a VM/SP HPO-only command. 
(G) TRACE performs a similar function. 


ATTACH CHANNEL VM/SP HPO only. 


(B) 
ATTACH raddr ATTACH rdeyv Incompatible. VM/XA SP ATTACH rdev 
| (B) (B) allows attachment of XSTORE, does not allow 


attachment of a 3330V, limits the range of 
devices attached to 256, does not accept A 
instead of AS, accepts access mode for a tape 
device, and runs asynchronously if issued on 
behalf of another user. 
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Table 22 (Page 2 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO Corresponding VM/XA 


Commands and Privilege | SP Commands and 
Classes Privilege Classes Notes 


ATTN ATTN | Compatible. 
(G) (G) 

ae AUTOLOG Compatible. 
ae B) (A, B) 


BACKSPAC BACKSPACE Incompatible. VM/XA SP BACKSPACE (or 

(D) (D) BACKWARD) does not allow logical printers 
and provides a one-line response instead of a 
two-line response. 


BEGIN BEGIN Upwardly compatible. VM/XA SP has 
(G) (G) additional operands: * and CPU. 


CACHE ATTACH CACHE its a VM/SP HPO-only command. 

(B) (B) ATTACH replaces CACHE OWN, SET 
SET CACHE CACHE replaces CACHE ON, and QUERY 
(B) CACHE replaces CACHE QUERY. (QUERY 
QUERY CACHE CACHE 0000-FFFF replaces CACHE QUERY 


(B) ALL.) 


Incompatible. VM/XA SP CHANGE has 
additional operands (TO/FROM, 
KEEP/NOKEEP, and MSG/NOMSG), 
truncates the name operand to 16 characters, 
does not support the DEST and UNCONV 
operands, sets DIST to the value in the directory 
when * is specified, includes the number of 
records and KEEP setting in the response, 
includes the new spool ID in the response if the 
file is changed to another user, allows a 
seven-digit response, and, for VM/SP HPO 
Release 4.2, does not allow users to specify 
SYSTEM and spoolid on the same command 
line. 


Incompatible. VM/XA SP CLOSE has 
additional operands (TO/FROM, 
KEEP/NOKEEP, and MSG/NOMSG), 
truncates the name operand to 16 characters, 
does not support the DEST and UNCONV 
operands, sets DIST to the value in the directory 
when * is specified, includes the number of 
records and KEEP setting in the response, and 
includes the new spool ID in the response if the 
file is closed to another user. 
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Table 22 (Page 3 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO Corresponding VM/XA 
Commands and Privilege SP Commands and 
Classes Privilege Classes 


COMMANDS COMMANDS 
(Any) (Any) 

QUERY COMMANDS 
(Any) 


Notes 


Incompatible. VM/XA SP COMMANDS (or 
the synonym QUERY COMMANDS) allows 
specification of a particular command, allows 
commands up to 12 characters long (VM/SP 
HPO commands may be up to 8 characters 
long), and does not include * in the list of 
commands. 


| COUPLE COUPLE Incompatible. The VM/XA SP COUPLE 
(G) (G) response contains CTCA, COUPLED, and 
DROPPED instead of CTC, COUPLE, and | 
DROP. 
CP CP Compatible. 
(Any) (Any) 
CPTRAP SET CPTRACE CPTRAP is a VM/SP HPO-only command. In 
(C) (A, C) VM/XA SP, the SET CPTRACE, TRSOURCE, 
TRSOURCE and TRSAVE commands provide the same 
(A, C, E) functions, plus more. 
ce . = In VM/SP HPO, CPTRAP traces and records 


CP events and virtual machine events. In 
VM/XA SP, SET CPTRACE traces CP events, 
TRSAVE records CP events, TRSOURCE traces 
virtual machine events, and TRSAVE records 
virtual machine events. 


In addition to the functions in CPTRAP, the 
VM/XA SP commands provide: 


Two new trace types, I/O and data 

¢ The ability to collect data in multiple trace 
files, not just a single trace file 

e The ability to record CP trace data to tape, 
not just to DASD 

e¢ The ability to define, enable, disable, and 

drop traces. 


DCP 1s a VM/SP HPO-only command. 
DISPLAY H replaces it. 


Incompatible. VM/XA SP DEFINE does not 


DISPLAY H 
(C, E) 
DEFINE 


DCP 
(C, EB) 


DEFINE 


(A, B, G) (A, G) allow all VM/SP HPO operands and does not 
REDEFINE accept A instead of AS. In VM/XA SP, you can 
(G) | use either DEFINE or REDEFINE to change a 


virtual device number. The virtual device 
number is four digits. 


DEFINE CHANNELS ---- VM/SP HPO only. 
(G) 
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Table 22 (Page 4 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO | Corresponding VM/XA 
Commands and Privilege SP Commands and 
Classes | Privilege Classes 


| DEFINE CONSOLE DEFINE CONSOLE | Upwardly compatible. VM/XA SP DEFINE 


(G) (G) CONSOLE supports an additional option: the 
virtual console device type (3215 or 3270). 


| DEFINE CTCA DEFINE CTCA Incompatible. VM/XA SP DEFINE CTCA 
(G) (G) requires the user ID of the virtual machine being 
coupled. 


DEFINE GRAF DEFINE GRAF Incompatible. VM/XA SP only supports a 
| (G) (G) device type of 3270. 

DEFINE LINE VM/SP HPO only. 

| G) 


DEFINEPRT DEFINE PRT Compatible. fo ™ 

@) (G) - 

DEFINE PUN | DEFINE PUN | Compatible. 

(G) | (G) | 

DEFINE RDR DEFINE RDR Compatible. 

(G) (G) 

DEFINE STORAGE DEFINE STORAGE Incompatible. VM/XA SP DEFINE STORAGE 

(G) (G) allows larger storage sizes, allows specifications 

| in megabyte increments, has an additional co 

response (STORAGE CLEARED - SYSTEM ee 


RESET), and does not allow the preferred 
virtual machine user to define storage larger 
than the contiguous storage within the V=R 
area. 


DEFINE SYSVIRT VM/SP HPO only. 

(A, B) | 

DEFINE TFB-512 -VM/SP HPO only. 

(G) a 


Ka zy 
Me 


| DEFINE TIMER VM/SP HPO only. 
(G) 


DEFINE 12305 T3330 DEFINE T2305 T3330 . | Compatible. 
| 13340 T3340 


(G) (G) 


| DEFINE T2314 12319 
T3310 T3370 


(G) 


| DEFINE 13350 T3375 
T3380 


© 


VM/SP HPO only. 


. Aenean Htc AR 


| DEFINE T3350 T3375 
T3380 


(G) 


Compatible. 


108 VM/XA System Product Conversion Notebook 


VM/SP HPO Conversion 


Table 22 (Page 5 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO Corresponding VM/XA 
Commands and Privilege SP Commands and 
Classes Privilege Classes 


DEFINE 1403 2501 DEFINE 1403 2501 
2540R 2540P 2540R 2540P 


(G) (G) 


DEFINE 1443 3088 
3262 3289E 


(G) 


DEFINE 3203 3211 
3505 3525 3800 3505 3525 3800 


(G) (G) 


DETACH CHANNEL VM/SP HPO only. 
(B, G) 


DETACH raddr | DETACH rdev Incompatible. VM/XA SP DETACH rdev does 
(B) (B) not allow the UNLOAD and LEAVE operands, 
issues a different response line from VM/SP 
HPO for each device detached, runs 
asynchronously if issued on behalf of another 
user, limits the range of devices detached to 256, 
accepts FR instead of From, and includes the 
user’s virtual device address in the response. 


Incompatible. VM/XA SP DETACH vdev may 
be invoked during an I/O trace and issues a 
separate response line for each device detached. 


Incompatible. The VM/XA SP DETACH vdev 
(CTCA) response contains CTCA and 
DROPPED instead of CTC and DROP. 


Notes 


Compatible. 


VM/SP HPO only. 


DEFINE 3203 3211 Compatible. 


DETACH yaddr 
(G) 


DETACH vdev 
(G) 


DETACH vaddr 
(CTCA) 


(G) 


DETACH vdey (CTCA) 
(G) 


DIAL Incompatible. The VM/XA SP DIAL response 
(Any) has five digits for the number of users. 
DISABLE DISABLE Incompatible. VM/XA SP DISABLE does not 
(A, B) (A, B, F) stop processing if 1t encounters an invalid device 


number. The VM/XA SP command does not 
issue a response for a return code of 0. 


DISABLE SNA DISABLE SNA Compatible. 
(A, B) (A, B, F) 

DISCONN DISCONNECT Incompatible. The VM/XA SP DISCONNECT | 
(Any) (Any) response has five digits for the number of users. 
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Table 22 (Page 6 of 20). VM/SP HPO and VM/XA SP Command Compatibility : 


VM/SP HPO Corresponding VM/XA 
Commands and Privilege SP Commands and 
Classes Privilege Classes 


DISPLAY DISPLAY 
(G) (C, E, G) 


Upwardly compatible. VM/XA SP DISPLAY 
has an upwardly compatible syntax for larger 
storage sizes and more levels of storage. 
VM/XA SP DISPLAY has an upwardly 
compatible response in that it always shows 
storage keys, displays storage as hexadecimal 
words (you can see the EBCDIC translation by 
using the T option), shows 4-byte addresses with 
the storage type indicator in front, includes one 
blank between the address and KEY in the 
response, displays all 16 CRs (VM/SP HPO 
displays only one CR when running with © 
ECMODE off), and issues the message 
SUPPRESSED LINE(S) SAME AS ABOVE 


only if the span is greater than hex 100 bytes. 
DISPLAY CAW DISPLAY CAW 


Compatible. 
| DISPLAY CSW DISPLAY CSW Compatible. 
| ©) (G) 


| DISPLAY PSW DISPLAY PSW Compatible. 
(G) (G) _ 


DISPLAY REGISTERS | DISPLAY REGISTERS | Incompatible. The VM/XA SP DISPLAY ee 
(G) (G) REGISTERS response contains CR instead of 
ECR for control registers. 


DISPLAY VECTOR DISPLAY VECTOR Incompatible. VM/XA SP checks the command 
(G) (G) for proper syntax prior to checking whether the 
Vector Facility is available. 


DMCP DUMP H DMCP is a VM/SP HPO-only command. 
(C, EB) (C, E) DUMP H replaces it. él . 
ee 


DRAIN Incompatible. VM/XA SP DRAIN does not 
(D) support logical printers and the response 
provides more detail (two lines) concerning the 
printer being drained. 
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Table 22 (Page 7 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO Corresponding VM/XA 
Commands and Privilege SP Commands and 
Classes Privilege Classes 


DUMP 
(G) 


Notes 


Upwardly compatible. VM/XA SP DUMP has 
an upwardly compatible syntax for larger 
storage sizes and more levels of storage. 
VM/XA SP DUMP has an upwardly compatible 
response in that it always shows storage keys, 
includes translation to EBCDIC, shows 4-byte 
addresses with the storage type indicator in 
front, includes one blank between the address 
and KEY in the response, displays all 16 CRs 
(VM/SP HPO displays only one CR when 
running with ECMODE off), dumps subchannel 
information blocks (SCHIBs) when in 370-XA 
mode, dumps all vector information when a 
Vector Facility is defined, does not always 
include GPRs, CRs, FPRs, and PSWs when 
DUMP is issued, does not provide vector 
registers or PSW as a default, issues the message 
SUPPRESSED LINE(S) SAME AS ABOVE 
only if the span is greater than hex 100 bytes. 


Incompatible. The VM/XA SP DUMP 


DUMP REGISTERS DUMP REGISTERS 


(G) (G) REGISTERS response contains CR instead of 
( ECR for control registers. 
=r DUMP VECTOR DUMP VECTOR Incompatible. VM/XA SP checks the command 
(G) (G) for proper syntax prior to checking whether the 


Vector Facility is available. 


ECHO ECHO Incompatible. The response is different. 
(G) (G) 


ENABLE ENABLE Incompatible. VM/XA SP ENABLE does not 
(A, B) (A, B, F) stop processing if it encounters an invalid device 

eS | number, does not issue a response for a return 
( | code of 0, and does not allow the SNA operand 


| to be combined with other operands on the 
| command line. 


EXTERNAL EXTERNAL Incompatible. VM/XA SP EXTERNAL has 
(G) (G) upwardly compatible syntax, allowing users to 
specify the type of external interrupt. 


FLUSH FLUSH Incompatible. VM/XA SP FLUSH does not 

(D) (D) allow logical printers and provides information 
about the file being flushed rather than the 
printer being flushed. 

FORCE FORCE Incompatible. The VM/XA SP FORCE 

(A) (A) response shows whether a user ID or the system 
issued the FORCE. 

FREE FREE Upwardly compatible. VM/XA SP FREE 

(B, D) (D) allows an additional option: userid LOGON. 
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Table 22 (Page 8 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO Corresponding VM/XA 
Commands and Privilege SP Commands and | 
Classes Privilege Classes Notes 


FREE PRT | FREE PRT © Compatible. 

(D) | (D) 
FREE PUN FREE PUN Compatible. . 

(D) | 


(D) 
HALT rdev Incompatible. VM/XA SP HALT rdev shows 
(A) (A) whether or not the system initiated the halt. 

HOLD PRT HOLD PRT Compatible. 
| (D) (D) 
HOLD PUN HOLD PUN Compatible. 


INDICATE INDICATE Incompatible. VM/XA SP INDICATE has a 
(A, E, G) (B, C, E, G) different response and does not support the 

FAVORED operand. Instead of INDICATE 
FAVORED, use QUERY SHARE (similar to 
INDICATE FAVORED with a percent) or 

QUERY QUICKDSP (similar to INDICATE 
FAVORED without a percent). INDICATE 
LOAD in VM/XA SP has these differences: 


e The response has five digits for the number 
of users. 

e AVGPROC represents the average processor 
utilization percentage for all processors 
combined, not including dedicated 
processors. 

¢ PROC represents the percentage of time that 

the system is running on the indicated 

processor, regardless of whether the 
processor is dedicated. 


Incompatible. VM/XA SP IPL does not allow 
the PMA or PMAV operands. 


Incompatible. VM/XA SP LINK must have 

vdev’s as base exposures for multiple exposure 
devices and gives access to all exposures, and the 
response has five digits for the number of users. 


Incompatible. VM/XA SP LOADBUEF allows 
specification of FOLD/NOFOLD independent 
of UCS or FCB options. 


LOADVFCB LOADVFCB Compatible. 
| G) (G) 


LOCATE LOCATE Incompatible. VM/XA SP LOCATE syntax 

(C, E) (C, E) © allows the user to specify a CP symbol to be 
located, and the response returns different 
control blocks. 


IPL 
(G) 


LOADBUF 
(D) 


LOADBUF 
(D) 
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Table 22 (Page 9 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


| ae VM/SP HPO Corresponding VM/XA 
& Commands and Privilege SP Commands and 
Classes Privilege Classes 


Incompatible. VM/XA SP LOCK allows 
locking a page with a CP system symbol, and 
issues an error message if an attempt is made to 


lock nonpageable storage. 


LOGOFF LOGOFF Incompatible. The VM/XA SP LOGOFF 
LOGOUT LOGOUT response has five digits for the number of users. 
(Any) (Any) 

| Incompatible. The VM/XA SP LOGON 


| response has five digits for the number of users 
and five characters for the device address. 


aa MESSAGE MESSAGE Incompatible. VM/XA SP MESSAGE displays 
( (A, B, Any) (A, B, Any) a time stamp and message on the same line. 


(A) 

MONITOR MONITOR Incompatible. VM/XA SP MONITOR uses 

(A, E) (A, E) different commands, produces different data 
records, and has different collection mechanisms. 


MSGNOH MSGNOH Compatible. 
(A, B) (B) 


( | | NETWORK VM/SP HPO only. VM/Pass-Through Facility 
i | | (A, B) commands as well as the CCLOAD and 
| CCDUMP utilities provide equivalent functions. 
NOTREADY NOTREADY Compatible. 
(G) (G) | | 
ORDER ORDER Incompatible. VM/XA SP ORDER allows a 
(D, G) (D, G) seven-digit response, does not allow the DEST 


operand, and, for VM/SP HPO Release 4.2, does 
not allow the specification of SYSTEM and 
userid by class D users. 


Incompatible. VM/XA SP PER is an alias for 
TRACE, has invocation, response, and 
functional differences including no equivalent for 
MASK without DATA, and provides certain 
equivalent functions with different operands: 


SAVE is provided by GOTO and APPEND. 

¢ GET is provided by GOTO and APPEND. 

¢ END CURRENT is provided by applying 
CLEAR to the active trace set. 

¢ END ident is provided by DELETE. 

e END set is provided by CLEAR. 

¢ END traptype has the same result achieved 
by deleting each trap separately. 

¢ GUESTR is provided by NODAT. 

GUESTV is provided by DAT. 


PER 
| | (A, B, C, D, E, F, G) 


: 
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Table 22 (Page 10 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO Corresponding VM/XA 
Commands and Privilege SP Commands and 
Classes Privilege Classes 


Incompatible. VM/XA SP PURGE does not 
allow the DEST and FORCE operands, does not | 
allow specification of ALL for device type (uses 
UR instead), does not have a default of ALL for 
selection criteria, allows a seven-digit response, 
and, for VM/SP HPO Release 4.2, does not 
allow the specification of SYSTEM and userid 
by class D users. 


VM/SP HPO only. 


| QUERY AFFINITY 
(A, E) 


Incompatible. VM/XA SP QUERY ALL 
displays real device information in numeric 
order, not by type and class. 


Incompatible. VM/XA SP QUERY devno does 
not allow logical printers and the response does 


QUERY ALL QUERY ALL 
(B) (D) | 

QUERY ccu QUERY devno 
(B) not include DEST information for unit record 
devices. 


(B) 
QUERY CHANNELS VM/SP HPO only. 
(G) 


QUERY CPASSIST VM/SP HPO only. 
(A, EB) 


QUERY CPLEVEL QUERY CPLEVEL 
(A, B, C, D, E, F, G) (G) 


QUERY CPTRAP QUERY CPTRACE 


Compatible. 


QUERY CPTRAP is a VM/SP HPO-only 


(C) (A, C) command. In VM/XA SP, the QUERY 
QUERY TRSOURCE CPTRACE, QUERY TRSOURCE, and 
(A, C, E, G) QUERY TRSAVE commands provide the same 
QUERY TRSAVE functions, plus more. 
(A, C, E, G) 

QUERY CPUID QUERY CPUID Compatible. 

© | (G) 

QUERY DASD volid QUERY DASD volid Compatible. 

(B) (B) 

QUERY DUMP QUERY DUMP Incompatible. VM/XA SP QUERY DUMP can 

(B) (B) return a printer as a dump unit, has no TEMP 


or DUMP fields, and has additional fields in the 
response. 


Incompatible. VM/XA SP QUERY FILES does 
not allow the DEST operand, allows a 
seven-digit response, and, for VM/SP HPO 
Release 4.2, does not allow the specification of 
SYSTEM and userid by class D users. 


QUERY GRAF QUERY GRAF Compatible. 
(B) (B) 
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Table 22 (Page 11 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO 
Commands and Privilege 
Classes 


Corresponding VM/XA 
SP Commands and 


Privilege Classes 
QUERY HOLD QUERY HOLD Incompatible. VM/XA SP QUERY HOLD 
(D) (B, D) allows a seven-digit response. 
QUERY JOURNAL VM/SP HPO only. 
(A, E) 
QUERY LINES ae VM/SP HPO only. 
(B) 


QUERY LINKS QUERY LINKS Compatible. 
(G) (G) 


QUERY LOGMSG QUERY LOGMSG Upwardly compatible. VM/XA SP QUERY 

(A, B, C, D, E, F, G) (A, B, C, D, E, F, G) LOGMSG issues a message if no LOGMSG 

exists, and the class B response includes line 
numbers. 


QUERY MITIME QUERY MITIME Incompatible. VM/XA SP QUERY MITIME 
(B) (A, B) displays each device or class of devices on a 
single line. 


QUERY NAMES QUERY NAMES Incompatible. The VM/XA SP QUERY 
(A, B, C, D, E, F, G) (A, B, C, D, E, F, G) NAMES response contains LOGN instead of 
LOGO and contains LOGL instead of LOGOL. 


QUERY TRACE Incompatible VM/XA SP QUERY TRACE (or 
(G) the synonym QUERY PER) displays the settings 
QUERY PER of all operands, not just those explicitly entered. 
(G) 


QUERY PF QUERY PF Compatible. 
(G) (G) 

QUERY PRIORITY VM/SP HPO only. | 
(A, E) 


QUERY PROCESSR QUERY PROCESSORS | Upwardly compatible. The VM/XA SP 

(A, B, C, E, G) QUERY PROCESSR command has PROCESSORS spelled out fully 

(A, B, C, E) (although it will accept PROCESSR) and has an 
upwardly compatible response for more than 
two processors. Also, the VM/XA SP command 
indicates whether a processor is the MASTER, 
an ALTERNATE, or a DEDICATED 


processor. 


QUERY PAGING 
(A, E) 


QUERY PER 
(A, B, C, D, E, F, G) 
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Table 22 (Page 12 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO Corresponding VM/XA 
Commands and Privilege SP Commands and 
Classes Privilege Classes 


| QUERY PRT | QUERY PRT 
(D, G) (D, G) 


Notes | 


Incompatible. In VM/XA SP, the command has 
an upwardly compatible syntax for operands not 
available in VM/SP HPO (EXP, XFER, 
AVAIL), has an upwardly compatible response 
for the operands KEEP and MESSAGE when 
ALL is not used, displays the names of open 
files in the response, indicates page copies by an 
asterisk in the copy count rather than with the 
FLASH name, does not support the DEST and 
PSF operands, and, for VM/SP HPO Release 
4.2, does not allow the specification of SYSTEM 
and userid by class D users. 


QUERY PSTORE is a VM/SP HPO-only 
command. QUERY XSTORE has the same 
function but a different response. 


Incompatible. See notes for QUERY PRT. 


QUERY XSTORE 
| (B) 


QUERY PSTORE 
(A, B) 


QUERY PUN 
(D, G) 


QUERY QDROP 
(A, E) 


QUERY raddr 
| B) 


QUERY PUN 
(D, G) 


VM/SP HPO only. 


QUERY rdev 
(B) 


Incompatible. VM/XA SP provides real device 
information in numerical order by device 
address, adds the STATUS operand, which is 
functionally equivalent to VM/SP HPO’s 
QUERY STATUS command, and displays 
SYSTEM or a user ID for the class B response, 
depending on whether a device has been started 
for a user or for the system. 


QUERY RDR QUERY RDR Incompatible. See notes for QUERY PRT. 

(D, G) (D, G) | 
QUERY RESERVE QUERY RESERVE Compatible. 

(A, E) (A, E) 

QUERY SASSIST VM/SP HPO only. | 

(A, E) 

QUERY SCREEN QUERY SCREEN Compatible. 

(G) (G) 

(G) (G) 


QUERY SET QUERY SET Upwardly compatible. The VM/XA SP response 

(G) (G) includes System/370 and 370-XA modes. The 
following VM/XA SP responses appear for 
compatibility purposes and are not setable, as 


they are in VM/SP HPO: ACNT OFF, ISAM 
OFF, ECMODE ON, ASSIST OFF, VMSAVE 
OFF, 370E OFF, STBYPASS OFF, STMULTI 
OFF, AFFINITY NONE, and SVCACCL OFF. 
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Table 22 (Page 13 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO 
Commands and Privilege 
Classes 


SP Commands and 
Privilege Classes 


QUERY STATUS 
(B) (B) 


QUERY SYSTEM QUERY SYSTEM 


| (B) (B) 


| QUERY TAPES QUERY TAPES 
(B) (B) 


| 
| 


| 
| 


QUERY TERMINAL QUERY TERMINAL 
(G) (G) 

QUERY TIME QUERY TIME 

(G) (G) 

QUERY UR QUERY UR 
(D) (B) 

QUERY USERID QUERY USERID 

(A, B, C, D, E, F, G) (G) 

QUERY userid QUERY userid | 
QUERY USERS QUERY USERS 

(A, B, C, D, E, F, G) (Any) 

QUERY vaddr QUERY vdev 

(G) (G) 


QUERY VECTOR QUERY VECTOR 

(B) (A, B, C, E) 
INDICATE VECTOR 
(C, E) 

QUERY VIRTUAL QUERY VIRTUAL 

ALL ALL 

(G) (G) 

QUERY VIRTUAL QUERY VIRTUAL 

CONSOLE CONSOLE 

(G) (G) 


Corresponding VM/XA 


Notes 


QUERY SPMODE VM/SP HPO only. 

(A, G) 

QUERY SRM QUERY SRM 
(A, E) (A, E) 


QUERY rdev STATUS 


Incompatible. The responses are different. 


QUERY STATUS is a VM/SP HPO-only 
command. QUERY rdev STATUS performs the 
identical function. 


Incompatible. VM/XA SP QUERY SYSTEM 
has an upwardly compatible syntax and 
upwardly compatible response, but the function 
is incompatible. The VM/XA SP command 
displays the current user access to a system 
DASD volume. 


Compatible. 


QUERY TDSK QUERY TDSK Compatible. 
(B) (B) 


Incompatible. Only VM/XA SP settings are 
displayed at the end of the response. 


Compatible. 


Incompatible. VM/XA SP QUERY UR does 
not allow logical printers, and the response does 
not include DEST information. 


Compatible. 


Compatible. 


Incompatible. VM/XA SP QUERY USERS 
displays five digits for the number of users. 


Incompatible. VM/XA SP QUERY vdey does 
not allow the DEST operand. 


Incompatible. The VM/XA SP QUERY 


VECTOR response lists only user IDs and the 
number of users; the other information can be 
found using VM/XA SP INDICATE VECTOR. 


Incompatible. VM/XA SP QUERY VIRTUAL 
ALL does not display CHANNELS and DEST 
information and has additional responses. 


Incompatible. The response is different. 
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Table 22 (Page 14 of 20). VM/SP HPO and VM/XA SP Command Compatibility — 


VM/SP HPO Corresponding VM/XA 
Commands and Privilege SP Commands and 
Classes Privilege Classes 


QUERY VIRTUAL QUERY VIRTUAL 
DASD DASD 
(G) (G) 


QUERY VIRTUAL QUERY VIRTUAL 
GRAF GRAF 
(G) (G) 


QUERY VIRTUAL QUERY VIRTUAL 
STORAGE STORAGE 
(G) (G) 


QUERY VIRTUAL QUERY VIRTUAL 
TAPES TAPES 
(G) (G) 


QUERY VIRTUAL QUERY VIRTUAL 
UR UR 
(G) (G) 


QUERY VIRTUAL QUERY VIRTUAL 
vaddr vdev 
(G) (G) 


QUERY VMSAVE VM/SP HPO only. 
(G) 


Upwardly compatible response. 


Incompatible. The responses are different. 


Incompatible. VM/XA SP QUERY VIRTUAL 
STORAGE displays larger storage sizes and 
displays sizes in megabyte increments. 


Incompatible. The response is different. 


Incompatible. The responses are different. 


QVM 


VM/SP HPO only. 
(A) 
READY READY Compatible. 
(G) (G) 


REPEAT REPEAT Incompatible. VM/XA SP REPEAT does not 
(D) (D) allow logical printers, does not provide the 


HOLD operand function, and has a different 
response. 

REQUEST REQUEST 

(G) | (G) 

RESET RESET Upwardly compatible. 

(G) (B, G) 

REWIND REWIND Compatible. 

(G) (G) | 

SAVESYS | SAVESYS Incompatible. VM/XA SP SAVESYS function 

(E) (E) | is different and VM/XA SP issues a message 
instead of a response. 

SCREEN SCREEN Compatible. 

(G) (G) | 
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Table 22 (Page 15 of 20). VM/SP HPO and VM/XA SP Command Compatibility 

VM/SP HPO Corresponding VM/XA 

Commands and Privilege SP Commands and 

Classes Privilege Classes | Notes | 
SEND SEND Compatible. 

(G) (G) 

SET ACNT VM/SP HPO only. 

(G) | 


SET AFFINITY 
(A, G) 


VM/SP HPO only. 


VM/SP HPO only. 
(G) 


SET AUTOPOLL SET AUTOPOLL 
(G) (G) 


SET CONCEAL SET CONCEAL 
(G) (G) 


Compatible. 


Incompatible. VM/XA SP SET CONCEAL 
OFF resets the break key to the last key 
specified on the TERMINAL BRKKEY 
command rather than to PAI. 


SET CPASSIST VM/SP HPO only. 
Ae (lane Gol \asiciaie 
SET CPCONIO SET CPCONIO Compatible. 
7 
SET CPUID Compatible. 
(G) (G) 


SET DUMP SET DUMP Incompatible. VM/XA SP SET DUMP does 

(B) (B) not allow the AUTO operand (use SET DUMP 
DASD or SET DUMP rdev instead) and does 
return a response. VM/XA SP dumps are in a 
different format and are incompatible with 
VM/SP HPO dumps. 


SET ECMODE VM/SP HPO only. 
(G) 
(G) (G) 


SET FAVORED SET SHARE SET FAVORED is a VM/SP HPO-only 
(A) (A) command. SET SHARE is similar to SET 


SET QUICKDSP FAVORED with a percent. SET QUICKDSP 1s 
(A) similar to SET FAVORED without a percent. 


(G) (G) 
El Sc ci 
(G) 
SET JOURNAL VM/SP HPO only. | 
ll RT bina 
SET LINEDIT SET LINEDIT Compatible. 
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Table 22 (Page 16 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO Corresponding VM/XA 
| Commands and Privilege | SP Commands and 
Classes Privilege Classes — 


| SET LOGMSG SET LOGMSG Incompatible. VM/XA SP SET LOGMSG has _| 
(B) (B) a limit of 50 lines of log message data. 
SET MIH SET MIH Compatible. 
G) G) 
SET MINWS VM/SP HPO only. | 
(E) | 


SET MITIME SET MITIME Incompatible. VM/XA SP SET MITIME has 

(B) (A, B) upwardly compatible syntax, allows setting by 
device address as well as class, and returns a 
blank response. 

SET MODE SET MODE Incompatible. VM/XA SP SET MODE does 

(F) 


(A, F) not require the CPU operand, has a different 
response, and gives a response to SET MODE 
RETRY QUIET. 


SET MSG SET MSG Compatible. 

SET NOTRANS SET NOTRANS Compatible. | 
SET PAGEX SET PAGEX Compatible. 

(G) (G) 


SET PAGING nn | VM/SP HPO only. | 
(E) | ) 
SET PFnn IMMED SET PFun IMMED Compatible. 

(G) (G) 

SET PFnn DELAYED SET PFun DELAYED Compatible. 

(G) (G) 

SET PFnn COPY SET PFun COPY Incompatible. VM/XA SP SET PF COPY 

(G) (G) requires specification of the printer address. 


SET PFnn RETRIEVE SET PFnn RETRIEVE Upwardly compatible. VM/SP HPO clears the 
(G) (G) RETRIEVE buffer after a disconnect. VM/XA 
SP saves the RETRIEVE buffer after a 
disconnect; however, you can use the CLEAR 
operand to clear the buffer at any time. 


SET PFnn TAB 
(G) 
SET PRIORITY 
(A) 


SET PFnn TAB 
(G) 


SET SHARE 
(A) 


Compatible. 


VM/SP HPO only. The SET SHARE command 
provides similar functions but is not compatible 
with the VM/SP HPO SET PRIORITY userid 
nn and SET FAVORED non commands. 


SET QDROP VM/SP HPO only. | 
(A) 
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SET STBYPASS VM/SP HPO only. 
(G) 
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Table 22 (Page 17 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO 
Commands and Privilege 
Classes 


Corresponding VM/XA 
SP Commands and 
Privilege Classes 


SET RECORD SET RECORD Compatible. 
(F) (F) 
SET RESERVE SET RESERVED Compatible. 
(A) (A) 


Incompatible. VM/XA SP SET RUN never 
forces RUN off for a disabled VM, a disabled 
VM with RUN set on displays RUNNING, and 


SET RUN SET RUN 
(G) (G) 
RUN is forced off when a user is tracing. 


(A) 

(G) (G) 

SET SRM Incompatible. The syntax is different. 
(E) (A) 


VM/SP HPO only. 


Compatible. 


Compatible. 


VM/SP HPO only. 


Compatible. 


VM/SP HPO only. 


Incompatible. VM/XA SP SHUTDOWN does 
not allow the REIPL raddr operand and displays 
an additional response indicating that shutdown 
has started. 


SLEEP SLEEP Incompatible. VM/XA SP SLEEP is not 

(G) (Any) terminated upon reconnection and supports the 
ATTN operand, which allows you to be notified 
if attention terminates the SLEEP. 7 


Compatible. 


Incompatible. VM/XA SP SPACE does not 
allow logical printers and does have a response. 
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| Table 22 (Page 18 of 20). VM/SP HPO and VM/XA SP Command Compatibility 


VM/SP HPO Corresponding VM/XA 
Commands and Privilege SP Commands and 
| Classes | Privilege Classes : 
SPMODE ao VM/SP HPO only. 
(A) 
SPOOL SPOOL Incompatible. VM/XA SP SPOOL does not 


(G) (G) allow the DEST operand, sets DIST to the value 
in the directory for DIST *, has a minimum 
truncation of NOT for NOTERM, accepts 
SPOOL PRT CLOSE PURGE and closes and 
purges the file, includes the number of records 
and the KEEP setting in the response, always 
displays responses whenever a file is closed, sets 
the distribution code (when DIST is specified) 
for all files created on the device to the code 
specified, does not put a file into user hold 
following CONT or HOLD, truncates a name 
identification to 16 characters, allows you to 
specify additional operands (KEEP/NOKEEP 
and MSG/NOMSG), and changes a reader in 
KEEP status to HOLD after reading. 


Incompatible. VM/XA SP SPTAPE gives a 
final completion response when the total 
operation is complete, does not allow the DEST 
operand, has no extended attribute buffer 
support, does not support the convert setting or 
hex 5A CCW content, and, for VM/SP HPO 
Release 4.2 users, requires a user ID if you 
specify one or more spool IDs. Also, in VM/XA 
SP, you may dump, load, and scan files using a 
user ID as the selection criterion, dump and load 
files using up to eight classes as selection criteria, 
and dump and load NSS, UCR, IMG, message 
repository, and system trace files. 


Incompatible. VM/XA SP START has a SEP 
operand, does not allow imbedded LOAD FCB 
CCWs, does not accept the FILEFCB and 
CFILEFCB operands, does not allow the DEST 
operand, does not allow logical printers, and has 
a different response. 


START START 
(D) (D) 
STCP is a VM/SP HPO-only command. 


STCP STORE H 

(C) STORE H replaces it. 

STORE STORE Upwardly compatible. VM/XA SP STORE has 

(G) (C, G) upwardly compatible syntax for larger storage 
sizes and more levels of storage. 

STORE CAW STORE CAW Compatible. 

(G) (G) 

STORE CSW | STORE CSW Compatible. 

(G) | (G) 
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Table 22 (Page 19 of 20). VM/SP HPO and VM/XA SP Command Compatibility 
VM/SP HPO Corresponding VM/XA 


Commands and Privilege SP Commands and 
Classes Privilege Classes Notes 


STORE PSW STORE PSW Compatible. 
(G) (G) 


STORE REGISTERS STORE REGISTERS Incompatible. VM/XA SP STORE 


(G) (G) . REGISTERS does not allow storing into 
odd-numbered floating-point registers. 


STORE STATUS STORE STATUS Compatible. 
(G) 


STORE VECTOR STORE VECTOR 
(G) (G) 


Incompatible. VM/XA SP checks the command 
for proper syntax prior to checking whether the 
Vector Facility is available. 


Incompatible. VM/XA SP SYSTEM clears 
registers and resets I/O for the CLEAR operand. 


( | SYSTEM SYSTEM 
(G) (G) 
operand: STORE STATUS. 


Also, VM/XA SP supports an additional 
TAG DEV TAG DEV Compatible. 
(G) (G) 
TAG FILE TAG FILE Compatible. | 
(G) (G) 


( TAG QUERY TAG QUERY Incompatible. VM/XA SP TAG QUERY issues 

| (G) (G) TAG BLANK instead of TAG MISSING if the 
TERMINAL TERMINAL 
| | () (G) 
| 
aa : | 
( | 


file did not contain a tag because it was either a 
file from the real card reader or an output file 

TRACE TRACE 

(G) (G) 


generated prior to VM/370 Release 2 PLC 11. 


Incompatible. VM/XA SP TERMINAL allows 
you to set OFF the SCRNSAVE option (an 
error message results whenever it 1s set on) and 
does not support the BRK KEY operand in line 
mode. 


Incompatible. VM/XA SP TRACE stops 
running after the instruction executes, displays 
only those branch instructions that are in the 
range of branches being traced, and, if the count 
exceeds the maximum value, does not display a 
per-branch count reset to one. Also, VM/XA 
SP supports additional operands and options 
including many from VM/SP HPO’s PER 
command. 


Incompatible. VM/XA SP TRANSFER does 
not allow the DEST operand, allows files 
created on any device to be transferred to any 
other device, has a different response, and, for 
VM/SP HPO Release 4.2, does not allow the 
specification of SYSTEM and userid by class D 
users. 


TRANSFER 
(D, G) 


TRANSFER 
(D, G) 
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Table 22 (Page 20 of 20). VM/SP HPO and VM/XA SP Command Compatibility 
VM/SP HPO Corresponding VM/XA 


Commands and Privilege SP Commands and 
Classes Privilege Classes 


| UNLOCK | UNLOCK Upwardly compatible. VM/XA SP UNLOCK 
(A) (A) allows unlocking pages with CP system symbols. 


VARY OFFLINE VARY OFFLINE Incompatible. VM/XA SP VARY OFF does 
(B) (B) | not allow logical printers and limits the range of 
devices varied to 256. 


VARY ONLINE - VARY ONLINE Incompatible. VM/XA SP VARY ON does not 
(B) (B) allow logical printers and limits the range of 


- devices varied to 256. 


VARY OFFLINE VARY OFFLINE Incompatible. VM/XA SP VARY OFFLINE 

PROCESSR PROCESSOR - PROCESSOR allows PROCESSOR to be ca 

(B) (B) spelled out fully and does not provide function | 
for the FORCE, VPHY, and VLOG operands. aed 


VARY raddr VARY rdev Upwardly compatible. VM/XA SP VARY rdev 
displays the number of devices varied on at the 
(B) 
end of the response. 


VMDUMP VMDUMP Upwardly compatible. 

(G) (G) 

WARNING WARNING Incompatible. VM/XA SP WARNING displays = 
(A, B) © (A, B, C) the time and message on the same line. (A a 


Asynchronous Commands 
Be careful using asynchronous commands because control could return to the issuer 
of the command before processing of the command completes. For example, when 
an operator issues the ATTACH command on behalf of another user, the 
attachment does not take place immediately; it occurs just prior to the other user 
being dispatched. In VM/XA SP, three commands are asynchronous: ATTACH, 
DETACH, and XAUTOLOG. (XAUTOLOG can also be used synchronously.) In Po 
VM/SP HPO, the ATTACH and DETACH commands are synchronous, and the 7 
XAUTOLOG command does not exist. 


VM/SP HPO and VMI/XA SP DIAGNOSE Code Compatibility 


Table 23 on page 125 contains compatibility information for VM/SP HPO 
DIAGNOSE codes. The compatibility categories are: 


¢ Compatible with VM/XA SP. The DIAGNOSE code exists in both systems and 
has equivalent syntax, responses, and functions. 


¢ Upwardly compatible with VM/XA SP. The DIAGNOSE code exists in both 
systems but there are differences in syntax, responses, or functions. Invocations 
and applications using the VM/SP HPO syntax should continue to execute — 
unchanged. 


¢ Incompatible with VM/XA SP. The DIAGNOSE code exists in both systems but 
differences in syntax, responses (including additional return codes for existing 
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functions), or functions may cause some invocations or applications using the 
previous syntax to execute incorrectly or not to execute at all. 


Refer to VM/XA SP CP Programming Services for complete descriptions of all 


DIAGNOSE codes. 


Table 23 (Page 1 of 3). VM/SP HPO and VM/XA SP DIAGNOSE Code Compatibility 


VM/SP HPO DIAGNOSE Code 
X'00' - Store Extended ID 


X'04' - Examine Real Storage 


X'08' - Virtuai Console Function 


X'OC' - Pseudo Timer 


X'10' - Release Pages | 


X'14' - Input Spool File Manipulation 


X'18' - Standard DASD I/O 


X'1IC' - Clear Error Recording 
X'20' - General I/O 


X'24' - Device Type, Features 


X'28' - Channel Program Modification 


X'2C' - DASD Start of LOGREC 
X'30' - Read Page of LOGREC 


X'34' - Read Dump Spool File 


X'38' - Read System Symbols 


Teacmeamememnend 


X'3C' - Directory 


X'40' - Clean-Up after IPL 


X'48' - Issue SVC76 Second Level 


X'4C' - Generate Accounting Records 
X'50' - Save 370x Image 


| X'54' - Control the Function of PA2 


Compatibility Notes 


Incompatible. VM/XA SP returns a different system name 
and a different bit map. 


Compatible. 7 
Compatible. 
Compatible. 
Compatible. 


Incompatible. VM/XA SP does not provide extended 
attribute buffer support. Also, the format of the block that is 
returned may be different. 


Incompatible. VM/XA SP issues return code 7 for different 
CCW problems. 


VM/SP HPO only. 


Incompatible. VM/XA SP returns only sense bytes 0 and | 
in Ry for return code 13. Also, VM/XA SP provides 0’s for 
sense bytes 2 and 3. 


Incompatible. VM/XA SP gives same control block fields, 
but doesn’t provide all bits from VDEVSTAT and 
VDEVFLAG. 


Incompatible. VM/XA SP provides an additional return 
code. 


VM/SP HPO only. 
VM/SP HPO only. 


Incompatible. A VM/XA SP dump file has a different 
format. 


VM/SP HPO only. 


Incompatible. VM/XA SP provides an additional return 


code. 
Upwardly compatible. VM/XA SP provides two clean-up _ 
routines after IPL. 


Upwardly compatible. VM/XA SP treats this as a NO-OP. 
The equivalent VM/XA SP function is provided by the CP 
command SET SVC76. 


Compatible. 
VM/SP HPO only. 


Compatible. 
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Table 23 (Page 2 of 3). VM/SP HPO and VM/XA SP DIAGNOSE Code Compatibility 


VM/SP HPO DIAGNOSE Code Compatibility Notes 


X'58' - 3270 Virtual Console Interface Incompatible. Differences in sequences of VM/SP HPO and 
VM/XA SP channel programs make these DIAGNOSE codes 
functionally inconsistent. | 


X'5C' - Error Message Editing Upwardly compatible. VM/XA SP uses four-digit message 
numbers for numbers over 999. Also, VM/XA SP returns a 
length of 11 for a four-digit number and will allow for 

| variable length headers. 


X'60' - Determine Virtual Storage Size Upwardly compatible. The VM/XA SP response can be 
greater than 16Mb. 


X'64' - Named Saved Segments Incompatible. VM/XA SP provides three new options: 
FINDSKEL, FINDSPACE, and FINDSEGA. VM/XA SP 
provides additional return codes for condition code 2. Also, 7 
VM/XA SP does not use return code 179. a 


X'68' - VMCF | Compatible. -_ 
X'6C' - Shadow Table Maintenance VM/SP HPO only. 


X'70' - Activating TOD Clock Compatible. 

Accounting 

X'74' - 3800 Named System Incompatible. VM/XA SP has a new condition code and 
new return codes. | 


X'78' - MSS Communications VM/SP HPO only. e oN 


X'7C' - Logical Device Support Incompatible. VM/XA SP has a limit of eight virtual 
machines that can create logical devices, and allows four-digit 
virtual device addresses. 


X'80' - MSSFCALL Compatible. _ 


X'84' - Directory Update Upwardly compatible. In VM/XA SP, the ACCOUNT field 
can accept eight account numbers, the PRIORITY field is 
accepted and ignored, VM/SP HPO-only options in the 
OPTIONS field are ignored, the MDISK field has an 
additional format that supports four-digit device addresses, 
and there are several new return codes associated with new 
functions. 


X'8C' - Access Device Dependent Incompatible. VM/XA SP may return a protection exception 
Information where VM/SP HPO does not. 


X'94' - VMDUMP Function Incompatible. VM/XA SP has additional operands. 


X'98' - Real Channel Program Support | Upwardly compatible. VM/XA SP supports real channel 
programs in 24-bit or 31-bit addressing mode in System/370 
or 370-XA mode virtual machines. 


X'AO' - Retrieve a Group Name Upwardly compatible. VM/XA SP provides additional code 
| to check for the presence of RACF. 


X'BO' - Access Information Saved for Incompatible. VM/XA SP has additional error codes. 
Protected Application Users | 


X'B4' - Virtual Printer External VM/SP HPO only. 


Attribute Buffer Manipulation 
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Table 23 (Page 3 of 3). VM/SP HPO and VM/XA SP DIAGNOSE Code Compatibility | 
VM/SP HPO DIAGNOSE Code Compatibility Notes 


X'B8' - Spool File External Attribute 
Buffer Manipulation 


X'DO' - 3480 Tape Volume Serial Compatible. 
Support 


X'D4' - Alternate Userid Compatible. 


X'D8' - Query Spool File Upwardly compatible. VM/XA SP has an additional code 
(0004) that allows access to spool file blocks that are in 
VM/XA format. 


VM/XA SP-Only DIAGNOSE Codes 
X'44' - Voluntary Time Slice End 


X'90' - Read Symbol Table 
X'A4' - DASD I/O for System/370 or 370-XA 
( X'A8' - General I/O for System/370 or 370-XA 
X'C4' - Handle Class Override Data for User Class Restructure (UCR) 
| X'EO' - System Trace File Interface 


| X'E4' - Return Minidisk Real Device Information. 


( | VM/SP HPO and VM/XA SP Message Compatibility 


Table 24 on page 128 compares VM/SP HPO and VM/XA SP messages. Messages 
listed are: 


e Upwardly compatible messages. The message number exists in both systems but 
the text of the messages differs. Applications using the VM/SP HPO message 
should continue to execute unchanged. 


¢ Incompatible messages. The message number exists in both systems but 
differences between message texts may cause applications that depend on 
message texts to execute incorrectly or not to execute at all. 


e VM/SP HPO-only messages. 


Messages not listed are: 


¢ Compatible messages. The message number exists in both systems and has the 
Same message text. 


¢ VM/XA SP-only messages. 
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For VM/SP HPO-only messages, the message text is from VM/SP HPO Release 5. 


For upwardly compatible and incompatible messages, if a message text differs 
between VM/SP HPO Release 4.2 and VM/SP HPO Release 5, the release level is 
indicated. Otherwise, the indication “VM/SP HPO” means the message texts in 
VM/SP HPO Release 4.2 and VM/SP HPO Release 5 are the same (with the 
exception, of course, that VM/SP HPO Release 5 uses uppercase and lowercase 
letters). 


Table 24 (Page 1 of 19). VM/SP HPO and VM/XA SP Message Compatibility 


No. Code Text, or System and Text 


009 IC VM/SP HPO: INVALID RANGE - range (addresses are padded and “.” or “:” is 
changed to “-”) | 
| VM/XA SP: Invalid range - range (what was entered on the command) 


014 HO Tape raddr dump tape capacity exceeded 

015 | HO Command not valid before LOGON: command 
016 HO TAG invalid for specified file type 

017 HO Insufficient screen space - clear screen and redial 


021 IC VM/SP HPO 4.2: RADDR MISSING OR INVALID [raddr] 
VM/SP HPO 5: Real device address missing or invalid [raddr] 
| VM/XA SP: A real device number was not supplied or it is invalid. 


022 IC VM/SP HPO 4.2: VADDR MISSING OR INVALID 
VM/SP HPO 5:. ___—i*Virtual device address missing or invalid 
| VM/XA SP: A virtual device number was not supplied or it was invalid. 


024 IC VM/SP HPO: {CYLS|BLKS|FORM NUMBER} missing or invalid 
| VM/XA SP: Cylinders missing or invalid 


027 HO Spoolid missing or invalid 

029 HO Filename and/or filetype missing or invalid 
032 HO Distcode missing or invalid 

034 HO Channel missing or invalid 

037 HO Tape raddr invalid for SPTAPE command 


038 IC VM/SP HPO: Parameter parameter for option option missing or invalid 
| VM/XA SP: Parameter for option option missing or invalid - parameter 
040 IC VM/SP HPO 4.2: © DEV raddr DOES NOT EXIST 
| VM/SP HPO 5: Device raddr does not exist (up to four spaces for address) 
| VM/XA SP: Device {rdev|vdev|idev} does not exist 


046 IC VM/SP HPO 4.2: (DEV rid|devtype raddr|volid) OFFLINE 
VM/SP HPO 5: (Device rid|devtype rdev) OFFLINE 
| VM/XA SP: type rdev offline 


048 HO Channel x does not exist 
051 HO Maximum virtual devices exceeded in directory 


053. IC VM/SP HPO: — userid not in CP directory (blanks are not suppressed in the user ID) 
| VM/XA SP: [XAUTOLOG failed for userid:] userid not in CP directory 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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Table 24 (Page 2 of 19). VM/SP HPO and VM/XA SP Message Compatibility 
No. Code Text, or System and Text 


058 IC VM/SP HPO: CTC vaddr busy on userid 
| VM/XA SP: CTCA vdev busy on userid 


059 UC VM/SP HPO: AUTOLOG failed for userid - message 
| VM/XA SP: {XAUTOLOG|AUTOLOG} failed for userid - {IPL missing|IPL 
| failed|accounting errors|incorrect password} 


062 HO ECMODE not set on 
063 HO Shadow table bypass; not set 
064 HO Shadow table bypass; reset 


065 HO Highest allowable high-water mark value is xxxxxk 
066 HO STMULTI option CSEG reset 
pO. 069 HO Incomplete recovery; “SYSTEM RESTART? or ‘BEGIN’ 
( 070 HO Device not available - MSS devices allocated 
071 HO Device not available - MSS cannot be accessed 
072 HO Device not available - raddr not proper type 
073. HO MSS device not available - MSS error 
074 HO Missing interrupt - device vaddr 
075 HO Device volid is not available 
( 076 HO The volid parameter is invalid 
077 HO Invalid request for device nnn 
078 HO MSS mount proceeding for volume volid 
079 HO CP command via central server is not possible 
080 HO No preallocated VMSAVE area 
081 HO VMSAVE area already in use, must use SET command 
a 082 HO More than one VMSAVE area allocated, must specify area name 
( 083 HO VMSAVE area does not contain valid saved system 
084 HO VARY failed, device rdev busy or reserved 
085 HO VARY failed, fatal I/O error - device raddr 
086 HO I/O error on DASD 
087 HO Device vaddr is in the process of being reset 
089 HO Device vadadr is in the process of being detached 


093 HO VM/SP HPO 4.2: DEV vaddr NOT DEFINED: ERROR IN CP DIRECTORY 
VM/SP HPO 5S: Device vdev not defined; error in CP directory 


094 UC VM/SP HPO: Storage exceeds allowed maximum 
| VM/XA SP: Storage exceeds allowed maximum of nun MEG 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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Table 24 (Page 3 of 19). VM/SP HPO and VM/XA SP Message Compatibility 


159 
161 


Code 
IC 


HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
IC 


HO 
HO 


HO 
HO 
HO 
HO. 
HO 
HO 
HO 
HO 
HO 


Text, or System and Text 


VM/SP HPO 4.2: © DEV vaddr NOT DEFINED; INSUFFICIENT FREE STORAGE 


VM/SP HPO 5: Device vaddr not defined; insufficient free storage 
VM/XA SP: Device vdev is not defined because the maximum number of devices 
is already defined. 7 


Device vaddr not defined; device type not allowed 

Device vdev2 not defined; device vdev/ as active I/O 

Device rid mode switch not possible 

VARY failed, environmental data device raddr 

userid xxx not linked; CP directory in use 

Userid vaddr not linked; insufficient free storage 

Channel x devices in use 

Channel x not attached to userid 

Insufficient free storage available for {attach/logon} request 
Channel x already defined by userid 

DASD raddr not ready 

type raddr not attached; channel x dedicated 

type vaddr not detached; channel x dedicated 

Device addr not {defined|varied}; channel x dedicated 
DASD vaddr not linked; channel x dedicated 

Channel x not attached; insufficient free storage 

DASD raddr not {linked|attached}; 3330V not accepted as system volume 


VM/SP HPO: _ devtype (rdev|idev) attached to userid (up to four spaces for address) 
VM/XA SP: type {rdev\|ldev } attached to userid 


type vaddr RESET BY userid 
USERID userid AT rdev WITH INVALID {LINK|LOGON} PASSWORD NO nannn 


HAS VIOLATED THE LIMIT OF limit [A =auserid] 


Channel x not attached; alternate paths defined 

DEVICE PATH rdev PRESENTED CC=3 ON I/O REQUEST 

DASD vaddr not attached; busy persists, IOBSTAT = xx, IOBCSW+4= yyyy 
Device raddr VARY failed, VARY in process 

raddrl raddr2 raddr3 subsystem devices not available 

‘CLUSTER =’ parameter missing from RDEVICE macro - device raddr 

UCS image name mismatch; image name loaded is xxxxx 

SPMODE on - cannot unlock Virtual = Real 

Shared page hexloc altered by userid 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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Table 24 (Page 4 of 19). VM/SP HPO and VM/XA SP Message Compatibility 


175 
176 
177 


178 
179 
180 


18] 
182 
183 
184 
185 
186 
187 
188 
189 
190 
19] 
192 


Code 
HO 
HO 
HO 
HO 
HO 
UC 


HO 
HO 
HO 
IC 


HO 
HO 
IC 


HO 
HO 
IC 


HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 


Text, or System and Text 

Invalid ECR x-hexdata 

Page hexloc not locked; shared page 

Changed shared page not written to auxiliary storage 
STATUS operand requires ECMODE 

VARY not performed, device raddr not ready 


VM/SP HPO: System name exceeds storage 
VM/XA SP: System name exceeds storage size; {nnnnnnnnK|nnnM} required 


System name volid volid not mounted 
System name DASD vaddr - incompatible SYSRES 
System name requires DASD vaddr 


VM/SP HPO: _ Paging error - {I/Ojaddress exception}: {checkpoint area 
invalidated|command terminated|IPL failed|page not locked|command 
complete|no dump created} 

VM/XA SP: Paging I/O error; IPL failed 


{RESERVE|name} already in use by userid 
Virtual = Real area in use by {userid|system} 


VM/SP HPO: Parameter exceeds nn characters 
VM/XA SP: Your PARM data exceeds the limit of mn characters. Correct your data 
string and reissue the IPL command. 


System name exceeds available DASD space 
System name volid volid not CP-owned 


VM/SP HPO: PER trace not in effect 
VM/XA SP: Trace not in effect 


Shared system name replaced with non-shared copy 
PER trace is active 

VM assist not active 

VM assist not available [on processor proc xx] 

CP assist level unnn not supported; CP assist disabled 
CP assist not available 

Timer assist not available 

Specified processor unavailable 

AFFINITY not set, system in uniprocessor mode 
No AFFINITY specified in directory 

{Processor| Vector} mn does not exist 


VARY {PROCESSOR|VECTOR} command failed 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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203 


208 
210 
211 
212 
213 
(214 
215 
216 
217 
218 
219 
220 


77) a 


222 
223 
224 
223 
226 
227 
228 
229 
230 


Code 
HO 
HO 
HO 
HO 
HO 
HO 
IC 


IC 


Text, or System and Text 

{PROCESSOR| VECTOR} nn ONLINE 
{PROCESSOR|VECTOR} nn OFFLINE 

370E FEATURE UNAVAILABLE ON PROCESSOR an 
LAST PATH TO DEVICE raddr ON PROCESSOR nn 
Command rejected; device raddr pending offline 

Virtual = Real area not available; damaged pages 


VM/SP HPO 5: Virtual =real area not available; insufficient storage 
VM/XA SP: Virtual = {Real|Fixed} area not available; insufficient storage 


VM/SP HPO 4.2: V=R AREA REQUIRES IPL BY DEVICE ADDRESS 
VM/SP HPO 5S: Virtual = Real area requires IPL by device address 
VM/XA SP: Virtual = {Real|Fixed} area requires IPL by device number 


Printer rid not enabled 

SWAPAGE class is dependent on swap 

MONITOR TAPE is already active 

MONITOR is not active 

MONITOR CPTRACE is already active 

MONITOR CPTRACE is not active 

Monitor active, DASTAP cannot be enabled dynamically 
SYSPROF class is dependent on schedule and DASTAP 
MONITOR TAPE not started, no class enabled 
Monitor not stopped, outstanding I/O 

End of monitor tape, monitor stopped by system 

Error on monitor tape, monitor stopped by system 
MONITOR to spool is already active 

TIME parameter specifies invalid time 

Start time must precede stop time 

Limit must be between 10 and 50000 

Invalid monitor userid specified, MONITOR not enabled 
‘FOR’ value spans midnight - command invalid 

‘FOR’ option invalid with AUTODISK off 

‘FOR’ option invalid with MONITOR on 

User of monitor does not exist 


VM/SP HPO: IPL SIO ERROR 
VM/XA SP: IPL {SIO|SSCH} ERROR 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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Table 24 (Page 6 of 19). VM/SP HPO and VM/XA SP Message Compatibility 


No. 
231 


2o2 


235 
236 
237 
238 
239 
240 


241 


242 
243 
244 
245 
246 
247 


250 
251 
252 
252 
255 


256 
257 
258 
268 

UC 


Code 


IC 


IC 


HO 
HO 
HO 
HO 
HO 
IC 


IC 


HO 
HO 
HO 
HO 
HO 
IC 


HO 
HO 
HO 
HO 
IC 


HO 
HO 
HO 
HO 


Text, or System and Text 


VM/SP HPO: IPL TIO ERROR 
VM/XA SP: IPL {TIO|/TSCH} ERROR 


VM/SP HPO: IPL UNIT ERROR; CSW csw SNS sense 
VM/XA SP: IPL UNIT ERROR, {CSW =csw|IRB = irb}, SNS = sense 


Device raddr varied online; unable to establish a path group id for channel path(s) raddr 
Device raddr VARY failed; unabie to establish a path group id for device 

Device raddr VARY failed; device cannot be assigned 

Device raddr varied offline; unassign failed 

Printer raddr drained; possible FCB-forms mismatch 


VM/SP HPO 4.2: PRT XXX, FCB-FORMS MISMATCH, FILEID nnnn 


(HELD|PURGED) 

VM/SP HPO 5S: Printer (rdev), FCB-forms mismatch; user(userid) Doone (spoolid) 
fuigidlpureed) 

VM/XA SP: The form length mounted on printer rdev does not ante the length 


described by the FCB fcb. 


VM/SP HPO 4.2: PRT xxx, INVALID LOAD MODULE mmmm SPECIFIED, FILE 
nnnn (held|purged) 

VM/SP HPO 5: Printer (rdev), invalid load module mmmm specified, user (userid) 
spoolid(spoolid) (held|purged) 

VM/XA SP: An undefined load image imagename was specified for printer rdev. 


Printer raddr (3800), intervention required, status code cc 
FLASH missing or invalid 

Image library missing or invalid 

CHARS missing or invalid 

FCB missing or invalid 


VM/SP HPO: 3800 NAMED SYSTEM image3800 CREATED 
VM/XA SP: NAMED IMAGE imagename CREATED 


370E feature is not available [on processorxx] 

370E feature {not active|now disabled} | 

Printer raddr, user userid spoolid nnnn requeued and held 
MODIFY missing or invalid 


VM/SP HPO: Printer raddr; page buffer destroyed, backup page count = nnnn 
VM/XA SP: PRINTER rdev; PAGE BUFFER DESTROYED, BACKUP PAGE 
COUNT = annn 


INSUFFICIENT VIRTUAL STORAGE 
RESIDUAL BYTE COUNT = annnnnnn (HEX) 
All 3800 data checks will be refiected 

XMEM feature not available 


= upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 


Not listed: compatible messages and VM/XA SP-only messages. 
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272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
285 
286 
287 
288 
290 
29] 
292 
293 
301 
302 


303 
304 
305 
306 
307 
308 
309 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 


Code 
HO 


Ic 


HO 
HO 
HO 
HO 
HO 
HO — 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 


HO 
HO 
HO 
HO 
HO 
HO 
HO 


Text, or System and Text 
XMEM feature not active 


VM/SP HPO 4.2: PRT nnn TOO MANY WCGM’S NEEDED FOR “CHARS”, 
FILE nnnn (HELD|PURGED) | 
VM/SP HPO 5: Printer raddr too many WCGM’s needed for ‘CHARS ’, user userid 
| spoolid nnnn {held|purged} 
VM/XA SP: The character sets specified for the printer rdev required more 
writable character generation modules than were available. 


Printer raddr, 3800 IML occurred 

DETACH rejected; virtual machine tracing I/O 

raddr has a mounted volume; MSS task not available to demount it 
raddr already SYSVIRT 

raddr not a 3330V 

Error demounting volume raddr 

Device raddr not a DASD 

DASD raddr not a VUA 

raddr already virtual 

MSS volume raddr not linked; demount in process, retry 

userid logging on, try again later 

userid logging off, try again later 

Printer raddr; page buffer destroyed, backup page count = nann 
LOGON from the initial screen was unsuccessful 

PMA guest given control due to code cde CP disabled WAIT 
Command rejected; {PMA|SPMODE]|VECTOR} in use 

PMA feature not available/enabled; re= rc{-ddd/] 

Command rejected; vaddr violates PMA restriction 

Requested file is not a CPTRAP file 


I/O error on OOC - {device address invalid|device type invalid|device busy, not ready, or 
real|paging error on spool} | 


OOC reader file not locatable 

CPTRAP is stopping, no input allowed 
CPTRAP/TRAPRED SELECTIVITY RESET 
CPTRATP is already active 

CPTRAP {CP\|virtual} cccc interface data ignored 
CPTRAP data lost 

Operand ignored; select table full 


Not listed: compatible messages and VM/XA SP-only messages. 
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Table 24 (Page 8 of 19). VM/SP HPO and VM/XA SP Message Compatibility 


320 


321 


o22 


323 


324 


325 


328 
329 


331 


334 
335 


UC = upwardly compatible, IC 


Code 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
IC 


IC 


IC 


IC 


IC 


IC 


IC 


HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 


Text, or System and Text 


Maximum number of trace elements exceeded 
More than {8 RANGES|1 PASS|1 STEP} specified on a command line 
PER failure - code n 


PER failure - code n, userid userid 
Command rejected; LOGMSG/DUMP being processed 
CPTRAP terminated due to I/O error 


Cache not available - already owned 


VM/SP HPO: 
VM/XA SP: 


VM/SP HPO: 
VM/XA SP: 


VM/SP HPO: 
VM/XA SP: 


VM/SP HPO: 
VM/XA SP: 


VM/SP HPO: 


VM/XA SP: 


VM/SP HPO: 


VM/XA SP: 


VM/SP HPO: 


VM/XA SP: 


Subsystem processing error - fault code = code - raddr|ss-xx-xx 
DASD rdev SUBSYSTEM PROCESSING ERROR - FAULT CODE 
= code - ss-XX-XX 


Subsystem storage equipment check - fault code=code - raddr/ss-xx-xx 
DASD rdev SUBSYSTEM STORAGE EQUIPMENT CHECK - 
FAULT CODE = code - ss-XX-XX 


Subsystem storage availability threshold crossed - raddr/ss-xx-xx 
DASD rdev SUBSYSTEM STORAGE AVAILABILITY 
THRESHOLD CROSSED-ss-XX-XX 


Subsystem storage is unusable - fault code = code - raddr/ss-xx-xx 
DASD rdev SUBSYSTEM STORAGE IS UNUSABLE - FAULT 
CODE = code-ss-XX-XX 


Subsystem storage must be initialized - fault code = code - 
raddr|ss-xx-xx 

DASD rdev SUBSYSTEM STORAGE MUST BE INITIALIZED - 
FAULT CODE = code - ss-XX-XX 


Storage director communication failure - fault code = code - 
raddr/ss-xx-xx 

DASD rdev STORAGE DIRECTOR COMMUNICATION FAILED - 
FAULT CODE = code-ss-XX-XX 


Track format not supported for paging device - fault code = code - 
raddr/ss-xx-xx 

PRT rdev TRACK FORMAT NOT SUPPORTED FOR PAGING - 
SS-XX-XX 


Reset write inhibit switch on paging device- raddr 


raddrl raddr2 raddr3 raddr4 improperly genned; varied offline 


raddr improperly genned, device cannot be used as SYSOWN 


message; mismatched device types at address rdev 


vaddr not process - use a vcutype VCU instead 


Soft error logging complete for subsystem storage - fault code = code - raddr/ss-xx-xx 


Soft error logging complete for controller - fault code = code - raddr/ss-xx-xx 


Soft error logging complete for device - fault code = code - raddr/ss-xx-xx 


= incompatible, HO = VM/SP HPO only. 


Not listed: compatible messages and VM/XA SP-only messages. 
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434 
435 


436 
437 
438 
44] 
442 


Code 
HO 
IC 


HO 
HO 
HO 
HO 
HO 
HO 
HO 
UC 


IC 


HO 
HO 


HO 
HO 
HO 
HO 
HO 
IC 


HO 
ite 


HO 
HO 
HO 
HO 
HO 


Text, or System and Text 
Caching terminated - fault code = code - raddr/ss-xx-xx 


VM/SP HPO: — Caching reinitialized - fault code = code raddr/ss-xx-xx 
VM/XA SP: DASD rdev CACHING REINITIATED-ss-XX-XX 


Area type type truncated for CP owned volume volid 
Area type type defaulted for CP owned volume volid 
Spool file exists in page area for CP owned volume volid 
SWSIZE too large for CP owned volume volid 

CP owned volume volid invalid type 

No devices sysgenned/online raddr 

DASD raddr SYSRES VOLID NOT volid 


VM/SP HPO: SYSRES DEVICE TYPE INVALID 
VM/XA SP: Sysres device type invalid or device rdev not operational 


VM/SP HPO: = System {temp space|checkpoint area} full 
VM/XA SP: All {paging|spooling} space is in use. 


CP ENTERED; TRANSLATION EXCEPTION, WHILE IN NON-EC MODE 


PAGING STORAGE ERROR OCCURRED WHILE ATTEMPTING RECOVERY 
FROM A SYSSPOOL PAGING ERROR 


No SVCACCL specified in directory 


Reader file spool error; file unchanged 

I/O error on spool device during accounting 

{Reader|Tape} raddr system spool space full; file purged 
{Console|Printer|Punch} vaddr fatal I/O error; now offline, file held 


VM/SP HPO 4.2: = RDR raddr ID CARD; userid NOT IN CP DIRECTORY 
VM/SP HPO 5: Reader raddr ID card; userid not in CP directory 


VM/XA SP: The ID card for reader rdev is invalid because userid is not in the CP 


directory. 


Reader raddr fatal I/O error; file purged 


VM/SP HPO: Paging error writing saved system 
VM/XA SP: [{SAVESYS|SAVESEG} command was not completed because a paging 


I/O error occurred while writing a page.] or [[ DEFSYS|DEFSEG} 
command processing cannot complete because a paging I/O error 
occurred while writing a page.] 


INTERRUPT PENDING. TO PROCEED TYPE YES, TO END TYPE NO 
System paging space not available, IPL terminated | 

Device is not available for ATTACH 

Not accepted; previous backspace still being processed 


Paging storage for [paging|swapping|] = xxK yyy% are not usable 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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No. 
443 
444 
454 
455 
456 
457 
458 
460 
461 
462 
463 
464 
465 
466 
467 
468 
469 
470 
471 
472 
473 


474 


476 
500 


501 


502 


UC 


Code 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 


HO 


HO 
IC 


IC 


IC 


Text, or System and Text 

Paging storage increment nnn is not usable 

nn additional paging storage increments are not usable 
{Line raddr|Device rid} disabled 

Line raddr not operational; {CC =3|command reject} 

CP entered; name - shared page hexloc altered 

Terminal SCRNSAVE unsuccessful 

A condition was detected that should not occur; line xxx will be disabled 
CTLR raddr {load|dump} failed; program check 

CTLR raddr IPL NOT REQUIRED; ENTER ‘YES’ TO CONTINUE 
CTLR raddr unit check; IPL required 

CTLR raddr unit check; restart in progress 

CTLR raddr CC = 3; press 3705 ‘LOAD’ button 

LINE TRACE TERMINATED DUE TO ERROR 
CTLR raddr IN BUFFER SLOWDOWN MODE 

CTLR raddr emulator lines in use by system 

CTLR raddr communications scanner failure | 
CTLR raddr {load|dump} failed; temp space not available 
CTLR raddr {load|dump} failed; paging I/O error 

CTLR raddr {load|dump} failed; unrecoverable I/O error 
Paging storage allocated for ¢itttttt = mmmm megabytes 


Paging storage starting increment xxxx for type (¢ttttttt is greater than maximum 
increment in the system 


Paging storage ending increment xxxx for type ¢ftttttt is greater than maximum increment 
and is defaulted 


System {directory|overrides} loaded from volume raddr 


VM/SP HPO: type raddr devrname CMD REJECT CMD =cm SNS= sense CSW =csw 
USERID = userid [{BBCCHH = bbcchh|BLOCK = nnnnnn}] 

VM/XA SP: type rdev AN OPERATION WAS TERMINATED BECAUSE A 
COMMAND REJECT ERROR OCCURRED 


VM/SP HPO: _ type raddr devrname INT REQ {CMD=cm SNS=sense CSW =csw 
USERID = userid {BBCCHH = bbechh| BLOCK = nnnnnn} 
VM/XA SP: type rdev REQUIRES OPERATOR INTERVENTION 


VM/SP HPO: _ type raddr devrname BUSOUT CK CMD=cm SNS= sense CSW =csw 
USERID = userid [{BBCCHH = bbcchh| BLOCK = nnnnnn} | 
VM/XA SP: GRAF rdev A BUS OUT PARITY CHECK OCCURRED 


= upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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Code | 


No. 


504 


505 


506 


507 


508 


509 


510 


Sil 
a2 


513 


514 


516 


. UC = upwardly compatible, IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


HO 
IC 


IC 


HO 


IC 


Text, or System and Text 


VM/SP HPO: 


VM/XA SP: 
VM/SP HPO: 


VM/XA SP: 
VM/SP HPO: 


VM/XA SP: 


VM/SP HPO: 


VM/XA SP: 


VM/SP HPO: 


VM/XA SP: 


VM/SP HPO: 
VM/XA SP: 
VM/SP HPO: 


VM/XA SP: 


VM/SP HPO: 


VM/XA SP: 


type raddr devrname EQUIP CK CMD =cm SNS= sense CSW =csw 
USERID = userid [{BBCCHH = bbcchh| BLOCK = nannnnn}| 
type rdev AN EQUIPMENT CHECK OCCURRED 


type raddr devrname DATA CK CMD=cm SNS = sense CSW = csw 
USERID = userid |{ BBCCHH = bbcchh| BLOCK = nannan} |] 
type rdev AN UNRECOVERABLE DATA CHECK OCCURRED 


type raddr devname OVERRUN CK CMD=cm SNS= sense CSW =csw 
USERID = userid [{BBCCHH = bbcchh| BLOCK = nnnnnn}] 

type rdev AN OPERATION WAS TERMINATED BECAUSE A 
DEVICE DEFERRED ACCESS OCCURRED 


DASDraddr devrname TRKCOND CK CMD=cm SNS= sense 
CSW =csw USERID = userid BBCCHH = bbcchh 

DASD rdev TRKCOND CK CMD=cm SNS = sense [IRB =irb 
USERID = userid] [BBCCHH = bbcchh] 


DASD raddr devrname SEEK. CK CMD =cm SNS = sense CSW = csw 
USERID = userid BBCCHH = bbdcchh 

DASD rdev SEEK CK CMD=cm SNS= sense [IRB =irb 

USERID = userid] [BBCCHH = bbcchh] 


type raddr devname PERM ERROR CMD=cm SNS = sense CSW =csw 
USERID = userid [BBCCHH = bbcchh] 

{DASD|PRT|PUN|RDR} rdev PERM ERROR CMD=cm SNS = sense 
[IRB =irb USERID = userid] [BBCCHH = bbcchh] 


DASD raddr devname TRKOVERUN CMD = cm SNS= sense 

CSW =csw USERID = userid BBCCHH = bbechh 

DASD rdev AN OPERATION WAS TERMINATED BECAUSE THE 
TRACK CAPACITY WAS EXCEEDED 


TAPE raddr devrname CONVERT CK CMD=cm SNS = sense 
CSW =csw USERID = userid 

TAPE rdev CONVERT CK CMD=cm SNS = sense [IRB = irb 
USERID = userid| | 


TAPE raddr devrname COMPAT CK CMD=cm SNS= sense CSW = csw 


VM/SP HPO: 


VM/XA SP: 


VM/SP HPO: 


VM/XA SP: 


TAPE raddr devrname LOAD POINT CMD =cm SNS = sense 
CSW =csw USERID = userid 

TAPE rdev LOAD POINT CMD =cm SNS = sense [IRB = irb 
USERID = userid] 


type raddr devrname FILE PROT CMD =cm SNS = sense CSW =csw 
USERID = userid [{BBCCHH = bbcchh| BLOCK = nnnnnn}| 

DASD rdev AN OPERATION WAS TERMINATED BECAUSE A 
FILE PROTECT ERROR OCCURRED 


type raddr devnhame ADDMRK CK CMD=cm SNS= sense CSW = csw USERID = userid 
BBCCHH = bbcchh 


VM/SP HPO: 


VM/XA SP: 


type raddr devname BAD SENSE CMD =cm SNS= sense CSW = csw 
USERID = userid [BBCCHH = bbechh|BLOCKnnnnnn| 
type rdev A UNIT CHECK WITH NO SENSE DATA OCCURRED 


= incompatible, HO = VM/SP HPO only. 


Not listed: compatible messages and VM/XA SP-only messages. 
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VM/SP HPO Conversion 


Table 24 (Page 12 of 19). VM/SP HPO and VM/XA SP Message Compatibility 
No. Code Text, or System and Text 


517 = IC VM/SP HPO: _ type raddr devname NOT/KNOWN CMD =cm SNS = sense 
USERID = userid 
VM/XA SP: type rdev AN OPERATION WAS TERMINATED BECAUSE AN 
UNRECOGNIZED ERROR OCCURRED 


518 IC VM/SP HPO: TAPE raddr devname RECV ERROR CMD=cm SNS = sense CSW = 
csw USERID = userid [BBCCHH = bbcchh| 
VM/XA SP: TAPE rdev AN ERROR OCCURRED WHILE TRYING TO 
RECOVER FROM A PREVIOUS ERROR 


519 =IC VM/SP HPO: TAPE raddr devrname PE BURST CMD=cm SNS= sense CSW = csw 
USERID = userid 
VM/XA SP: TAPE rdevy PE BURST CMD=cm SNS= sense [IRB =irb 
USERID = userid] 


$20 IC VM/SP HPO: type raddr devname CHAN ERROR CMD=cm SNS= sense CSW = csw 
| USERID = userid [BBCCHH = bbcchh| BLOCK = nnnnnn] 
VM/XA SP: type rdev CHAN ERROR CMD=cm SNS = sense [IRB = irb 
USERID = userid] [BBCCHH = bbcchh| 


$21 IC VM/SP HPO: _— type raddr devname NO DEVICE CMD=cm SNS=sense CSW =csw 
USERID = userid [BBCCHH = bbcchh|BLOCK = nannnn] 
VM/XA SP: type rdev has no available channel paths 


522 HO TAPE raddr devname ERASE CK CMD=cm SNS= sense CSW = csw USERID = userid 


523 HO TAPE raddr devrname CONTROL CK CMD=cm SNS= sense CSW =csw 
USERID = userid 


524 IC VM/SP HPO: — type raddr devrname LOAD CHECK CMD=cm SNS = sense CSW = csw 
USERID = userid 
VM/XA SP: PRT rdev AN OPERATION WAS TERMINATED BECAUSE A 
LOAD CHECK OCCURRED 


525. IC VM/SP HPO: _ type raddr devrname FORMAT CK CMD=cm SNS = sense CSW = csw 
USERID = userid 

VM/XA SP: {RDR | PUN} rdev FORMAT CK CMD=cm SNS = sense [IRB = irb 
USERID = userid] 


526 §=6IC VM/SP HPO: TAPE raddr devrname DSE FAILED CMD=cm SNS= sense CSW =csw 
USERID = userid 
VM/XA SP: type rdev AN OPERATION WAS TERMINATED BECAUSE A 
DATA SECURITY ERASE (DSE) CHECK OCCURRED 


527 HO type raddr devrname LOST DATA CMD=cm SNS = sense CSW =csw USERID = userid 
528 HO type raddr devname TIMEOUT CMD =cm SNS=sense CSW =csw USERID = userid 


529. IC VM/SP HPO: _ type raddr devrname PARITY CK CMD=cm SNS= sense CSW = csw 
USERID = userid 
VM/XA SP: PRT rdev BUFFER PARITY ERROR OCCURRED 


530 IC VM/SP HPO: GRAF raddr devrname UNIT SPEC CMD =cm SNS= sense CSW = csw 
USERID = userid 
VM/XA SP: GRAF rdev A UNIT SPECIFICATION OCCURRED 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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VM/SP HPO Conversion | 


Table 24 (Page 13 of 19). VM/SP HPO and VM/XA SP Message Compatibility 


No. 


532 


533 


534 


535 


536 


538 
539 
540 
546 
547 
550 
551 
552 
555 
558 
559 
560 
561 
580 


581 


UC = 


Code 
IC 


iC 


HO 


HO 


HO 


IC 


HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
HO 
iC 


IC 


Text, or System and Text 


VM/SP HPO: GRAF raddr devname CNTRL CHECK CMD =cm SNS = sense 
CSW = csw USERID = userid 
VM/XA SP: GRAF rdev A CONTROL CHECK OCCURRED 


VM/SP HPO: GRAF raddr devname OP CHECK CMD =cm SNS= sense CSW = csw 


USERID = userid 
VM/XA SP: GRAF rdev AN OPERATION WAS TERMINATED BECAUSE AN 
OPERATION CHECK OCCURRED 


DASD raddr devname CHECK DATA CMD =cm SNS = sense CSW = csw 
USERID = userid BLOCK =nnnnnn 


DASD raddr devname BKSIZE EX CMD =cm SNS= sense CSW =csw USERID = userid 
BLOCK =znnnnnn . 


DASD raddr devrname WRT INHIBT CMD=cm SNS= sense CSW = csw 
USERID = userid BLOCK = nnnnnn 


VM/SP HPO: _ raddr devname reports disabled interface; fault code = code; notify CE 
VM/XA SP: rdev devrname REPORTS DISABLED INTERFACE - FAULT 
CODE = cccc 


type raddr devrname PROG ERROR CMD =cm SNS = sense CSW =csw USERID = userid 
TAPE raddr devname BOT FAIL CMD=cm SNS = sense CSW =csw USERID = userid 
PRT raddr devrname MAINT REQ CMD =cm SNS= sense CSW =csw USERID = userid 
Interruption {cleared|pending}; {device|control unit} raddr, CSW csw, userid userid 
Missing interrupt monitoring not available 

Error recording area 90 percent full; run CPEREP 

Error recording area full; run CPEREP 

Formatting error recording area 

Error recording area cleared; user userid 

Unrecoverable I/O error; error recording disabled 

SRF vaddr not accessible: frames not on error cylinders 

Errors on SRF vaddr: frames not on error cylinders 

More than 50 MCH or CCH frames were read from SRF vaddr 


VM/SP HPO: TAPE rdev devrname NO ERR SNS CMD=cm SNS= sense CSW =csw 
USERID = userid 

VM/XA SP: TAPE rdev A SENSE COMMAND WAS ISSUED WITH NO 
OUTSTANDING UNIT CHECK 


VM/SP HPO: TAPE rdev devrname DISPLAY CK CMD=cm SNS = sense CSW =csw 
USERID = userid | 

VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A 
LOAD DISPLAY CHECK OCCURRED 


upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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VM/SP HPO Conversion 


Table 24 (Page 14 of 19). VM/SP HPO and VM/XA SP Message Compatibility 
No. Code Text, or System and Text 


582 =IC VM/SP HPO: TAPE rdev devname WRITEIC CK CMD=cm SNS= sense CSW = csw 
USERID = userid 
VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A 
WRITE ID MARK CHECK OCCURRED 


583 HO TAPE raddr devname WRITEID CK CMD=cm SNS= sense CSW =csw 
USERID = userid 


584 =IC VM/SP HPO: TAPE rdev devname NOT CAPABL CMD=cm SNS= sense CSW = csw 
USERID = userid 
VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A 
CAPABILITY CHECK OCCURRED 


585 IC VM/SP HPO: TAPE rdev devname TAPE VOID CMD=cm SNS=sense CSW = csw 
USERID = userid 
on VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A 
( ‘ TAPE VOID CHECK OCCURRED 


586 IC VM/SP HPO: TAPE rdev devrname TENSION CMD=cm SNS= sense CSW = csw 
USERID = userid 
VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE OF A 
LOSS OF TENSION ON THE TAPE 


587 IC VM/SP HPO: TAPE rdev devrname LENGTH CK CMD=cm SNS= sense CSW =csw 
USERID = userid 
VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A 
TAPE LENGTH ERROR OCCURRED 


( 588 IC VM/SP HPO: TAPE rdev devname BKW AT BOT CMD=cm SNS= sense CSW = csw 
USERID = userid 
VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE THE 
PHYSICAL END OF TAPE WAS ENCOUNTERED 


589 =6-IIC VM/SP HPO: TAPE rdev devrname PHYS EOT CMD=cm SNS =sense CSW = csw 
USERID = userid 
VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE THE 
BEGINNING OF THE TAPE WAS ENCOUNTERED 


( 590 HO TAPE raddr devname UNLOAD ERR CMD=cm SNS = sense CSW =csw 
; USERID = userid 


591 =IC VM/SP HPO: TAPE rdev devname NO RECORD CMD=cm SNS= sense CSW =csw 
USERID = userid 
VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE 
DESIRED BLOCK WAS NOT FOUND 


$92 =6IC VM/SP HPO: TAPE rdev devrname DRIV ASGND CMD =cm SNS= sense CSW = csw 
USERID = userid 
VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE THE 
DRIVE IS ASSIGNED ELSEWHERE 


593 =6IC VM/SP HPO: = TAPE rdev devrname DRIV OFFLN CMD=cm SNS = sense CSW = csw 
USERID = userid 
VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE THE 
DRIVE IS OFFLINE 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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VM/SP HPO Conversion 


Table 24 (Page 15 of 19). VM/SP HPO and VM/XA SP Message Compatibility 


No. 


395 


596 


597 


598 


601 


— 602 


603 


605 
609 
610 


oll 
612 
613 
614 
615 
616 


617 
618 
619 


a RINE RRR: 


Code 
IC 


IC 


IC 


IC 


IC 


IC 
IC 
UC 


HO 
HO 
IC 


HO 
HO 
HO 
HO 


HO 


HO 


HO 
HO 
HO 


Text, or System and Text 


VM/SP HPO: TAPE rdev devname CU CK1 CMD=cm SNS =sense CSW =csw 
| USERID = userid 

VM/XA SP: TAPE rdev A CONTROL UNIT CHECK ONE ERROR OCCURRED 

VM/SP HPO: TAPE rdev devrname CU ERP CMD=cm SNS=sense CSW = csw 
USERID = userid | 

VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A 
CONTROL UNIT ERP FAILURE OCCURRED 

VM/SP HPO: TAPE rdev devname CU INCOMPA CMD=cm SNS= sense CSW=csw 
USERID = userid | 

VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE THE 
CONTROL UNIT AND DRIVE ARE INCOMPATIBLE 

VM/SP HPO: TAPE rdev devrname RD OPP CK CMD=cm SNS= sense CSW =csw 
USERID = userid 

VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A 
READ OPPOSITE CHECK OCCURRED 

VM/SP HPO: TAPE rdev devname BLK ID SEQ CMD=cm SNS= sense CSW =csw 
USERID = userid 

VM/XA SP: TAPE rdev AN OPERATION WAS TERMINATED BECAUSE OF 
AN INVALID BLOCK ID SEQUENCE | 

VM/SP HPO: CHANNEL CONTROL CHECK DEV raddr; USER userid 

VM/XA SP: type rdev A CHANNEL CONTROL CHECK OCCURRED 

VM/SP HPO: INTERFACE CONTROL CHECK DEV raddr; USER userid 

VM/XA SP: type rdev AN INTERFACE CONTROL CHECK OCCURRED 

VM/SP HPO: CHANNEL ERROR 

VM/XA SP: CHANNEL ERROR; RESTART SYSTEM 


CHANNEL CHECK RECORDING FAILURE 
MACHINE CHECK; PROCESSOR CONTROLLER DAMAGE cpuid 


VM/SP HPO: 
VM/XA SP: 


MACHINE CHECK; SUPERVISOR DAMAGE cpuid 
CHECK-STOP ON CPU nn 


MACHINE CHECK; SYSTEM INTEGRITY LOST cpuid 

MACHINE CHECK; TIMING FACILITIES DAMAGE 

SOFT MACHINE CHECK RECORDING DISABLED cpuid 

MACHINE CHECK; DAMAGED PAGE NOW DELETED cpuid 

MACHINE CHECK RECORDING FAILURE cpuid 

MACHINE CHECK; USER userid TERMINATED (cpuid|F cpuid (OFFLINE|ERROR 


n)) 


MACHINE CHECK; BUFFER OR DLAT DAMAGE cpuid . 
{INSTRUCTION RETRY|MAIN STORAGE} NOW IN {RECORD|QUIET} cpuid 


MACHINE CHECK; OPERATION TERMINATED {cpuid|VF cpuid} 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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VM/SP HPO Conversion 


Table 24 (Page 16 of 19). VM/SP HPO and VM/XA SP Message Compatibility 
oo No. Code ‘Text, or System and Text 
( 620 HO MACHINE CHECK; ATTACHED PROCESSOR NOT BEING USED 
621 HO MACHINE CHECK; AFFINITY SET OFF 
622 HO MACHINE CHECK; MULTIPLE CHANNEL ERRORS 
623 HO CHANNEL SET CONNECTED TO PROCESSOR nn 
624 HO MACHINE CHECK; EXTERNAL DAMAGE 


625 HO ALTERNATE PROCESSOR RECOVERY SUCCESSFUL; PROCESSOR nn 
OFFLINE 


627 HO MACHINE CHECK; STORAGE DEGRADATION FOR userid 
628 HO DEGRADATION; CP WILL TRY RECOVERY IN 1 MINUTE 
629 HO SOFT MACHINE CHECK REPORTING NOW ENABLED 


( ; 704. IC VM/SP HPO 4.2: DEV rdev NOT OPERATIONAL 
i VM/XA SP: DEVICE {rdev|vdev} NOT OPERATIONAL 


705. IC VM/SP HPO: _ [I/O error addr CSW =csw sense = sense input = bbcchh 
output = bbechh|nnnnnn CCW = cew] or [I/O error RESID = resid 
SENSE = sense LINE = addr] 
VM/XA SP: I/O ERROR rdev|vdev IRB irb SNS sense 
[INPUTbbcchh|OUTPUTbbcchh| CCW ccw 


706 HO Line addr not enabled 
( oa 707 HO MACHINE CHECK 


710) =6IC VM/SP HPO: DEV raddr INTERVENTION REQUIRED 
VM/XA SP: DEVICE {rdev|vdev} INTERVENTION REQUIRED 


718 UC VM/SP HPO: OUTPUT UNIT IS FILE PROTECTED 
VM/XA SP: OUTPUT UNIT IS FILE PROTECTED — TAPE {rdev|vdev} 


719 HO INVALID FILENAME OR FILE NOT FOUND 
720 HO ERROR IN {routine|nnnnnn} 


ike 725 IC VM/SP HPO: DASD INPUT DEVICE WAS(S) LARGER THAN OUTPUT 
( DEVICE DO YOU WISH TO CONTINUE? RESPOND YES NO OR 
REREAD: 
VM/XA SP: SOURCE DASD DEVICE WAS (IS) LARGER THAN OUTPUT 
DEVICE. DO YOU WISH TO CONTINUE? RESPOND YES OR 
NO: 


727 HO FLAGGED TRK xxxxxxxxxxxx HAS NO PROPER ALTERNATE; SKIPPING THIS 
TRACK 


730 HO DEV raddr NOT OPERATIONAL OR NOT READY 

732 HO MACHINE CHECK 

734 HO TYPE OR CYL INVALID 

735 HO FATAL DASD I/O ERROR. CSW =csw 

736 HO IO ERROR raddr {CCHHR =cchhr|BLOCK =nnnnnn} SENSE = sense 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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Table 24 (Page 17 of 19). VM/SP HPO and VM/XA SP Message Compatibility | 


809 


Code 
HO 
HO 
HO 


HO 
HO 


HO 
HO 
UC 


HO 


Text, or System and Text 
INVALID OPERAND 
DEVICE raddr INTERVENTION REQUIRED 


FLAGGED PRIMARY TRACK HAS NO ALTERNATE ASSIGNED, IO ERROR 
FOLLOWS 


PACK MOUNTED IS 3340-35, NOT 3340-70. MOUNT ANOTHER OR RESPECIFY 


DEVICE raddr IS zzzz, NOT xxxx-nn AS SPECIFIED RESPECIFY OR NOTIFY 
SYSTEM SUPPORT 


I/O ERROR raddr CODE= E4 CSW= csw,READ,M44A 
message, please re-enter this command 


VM/SP HPO: OPERAND MISSING 
VM/XA SP: OPERAND MISSING [FOLLOWING PROFILE profname|USER 
userid| 


DEV raddr NOT OPERATIONAL 
I/O ERROR raddr CSW csw SENSE sense 
MACHINE CHECK 


VM/SP HPO: DUPLICATE UNIT DEFINITION 

VM/XA SP: DUPLICATE {CONSOLE|UNIT} DEFINITION FOLLOWING 
{PROFILE profname|USER userid} 

VM/SP HPO: INVALID CLASS DEFINITION 

VM/XA SP: INVALID CLASS DEFINITION - class 


DUPLICATE CLASS DEFINITION 


BOR aeari il MOVE vadAu TO 


Incomplete machine - tell your system administrator 
Maximum password attempts exceeded, try again later 
Store exceeded maximum element | 

Command rejected, other virtual machines logged on 

Free storage page 1s not available 

Command ected: devices not dedicated 

Command rejected, spool devices not drained 

Single processor mode ON rejected - error condition 

Single processor mode OFF rejected 

Command rejected, virtual address not equal to real address 
Command rejected, VM/370 attached processor mode 
SINGLE PROCESSOR MODE ACTIVE 

Command rejected, TRACE/ADSTOP/CCW translation in effect 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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VM/SP HPO Conversion 


Table 24 (Page 18 of 19). VM/SP HPO and VM/XA SP Message Compatibility 
No. Code Text, or System and Text 


812 HO [SCLP|MSSF] RESPONSE CODE TO VARY [CP|VECTOR] {ON|OFF} IS nnnn 


850 =I VM/SP HPO: UNABLE TO READ DUMP FROM READER 
VM/XA SP: UNABLE TO READ DUMP 


851 HO TEM DUMP FILES ALREADY EXIST 

861 HO DUMP FILE filename NOT FOUND 

864 HO PAGE REFERENCED NOT AVAILABLE WHILE EDITING xxxxxxxx 
899 HO REWIND NOT PERFORMED 

900 HO SYSTEM RECOVERY FAILURE; PROGRAM CHECK 

901 HO SYSTEM RECOVERY FAILURE; MACHINE CHECK 


902 IC VM/SP HPO: SYSTEM RECOVERY FAILURE; FATAL I/O ERROR 
( - {NUCLEUS|WARM} AREA 
VM/XA SP: [System recovery failure; fatal I/O error] or [SYSTEM RECOVERY 
FAILURE; FATAL I/O ERROR] 


903 HO System recovery failure; volid volid allocation error {cylinder cylinder|page page} 
905 HO SYSTEM DUMP FAILURE; PROGRAM CHECK 
906 HO SYSTEM DUMP FAILURE; MACHINE CHECK 
907 HO SYSTEM DUMP FAILURE; FATAL I/O ERROR 


a 908 IC. VM/SPHPO: SYSTEM FAILURE; CODE - code; PROCESSOR nn 
( ; VM/XA SP: | SYSTEM FAILURE ON CPU nnnn, CODE - code 


909 =IC VM/SP HPO: SYSTEM DUMP DEVICE NOT READY 
VM/XA SP: SYSTEM DUMP DEVICE dev NOT READY 


910 HO SYSTEM RECOVERY FAILURE; INVALID WARM START AREA 
911 HO SYSTEM RECOVERY FAILURE; WARM START AREA FULL 
913 HO CP-owned volid xxxxxx invalid for 3330V 
914 HO Trace table is smaller than requested 

( | 915 HO Permanent I/O error on checkpoint area 
916 HO Error allocating spool file buffers 
917 HO Checkpoint area invalid; clear storage and cold start 


918 HO SYSTEM DUMP FAILURE; STATUS NOT STORED FOR ABENDING 
PROCESSOR 


919 HO Checkpoint area is invalid; checkpointing terminated 
920 HO No warm start data; checkpoint start for retry 


921 HO System recovery failure; unrecoverable I/O error 
922 HO System recovery failure; invalid spooling data 
923. -HO Failing storage frame at location rstor 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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VM/SP HPO Conversion 


Table 24 (Page 19 of 19). VM/SP HPO and VM/XA SP Message Compatibility 
No. Code Text, or System and Text 


924 HO xxxx additional failing storage frames exist 
925 HO System auto dump reallocated to DASD raddr 
927 HO Storage allocation has been altered. FREE or TRACE was too large 


928 HO Permanent I/O error in warm start data area 
944 HO Error allocating {console|reader|printer|punch} file user userid spoolid nnnn savedate 
save time | 


950 HO Operator not logged on; explicit LOGON required 


951 IC VM/SP HPO: — CP volid volid not mounted 
VM/XA SP: {CP|USER} VOLID volid NOT MOUNTED 


952 IC VM/SP HPO: — nannnK system storage 
VM/XA SP: mnnnnM SYSTEM STORAGE “ere 


953 IC VM/SP HPO: — Unable to allocate system auto dump 
VM/XA SP: CP is unable to allocate system DASD dump space. 


954 IC VM/SP HPO: = DASD radar volid volid not mounted; duplicate of DASD raddr 
VM/XA SP: DASD anunn VOLID vvvwvwvv IS A DUPLICATE OF DASD dddd 


956 HO DASD raddr VOLID volid NOT MOUNTED; NOW OFFLINE 


957 HO STORAGE SIZE = xxxxx K, NUCLEUS SIZE = xxx DYNAMIC PAGING SIZE = 
xxxxx K, TRACE TABLE SIZE = xxx K, FREE STORAGE SIZE = xxxx K, 
VIRTUAL=REAL SIZE = xxxxxK © 


ao 
958 HO ATTACHED PROCESSOR NOW OPERATIONAL . J 
959 HO Attached processor not online 
960 HO System warm start data saved 
962 HO CP-owned DASD radadr volid; volid invalid allocation record 
963 HO Second processor not online 
964 HO Processor xx IPLed; processor yy initialized 
966. HO Initialization complete % | 


967 HO Disconnect userid- system restarted {mmmnnn| SHUTDOWN; and system console not 
VM operator console 


968 HO System shutdown requested 
970 HO TOD CLOCK SYNC CHECK RECEIVED © 
971 HO System is {uniprocessor|attached processor|multiprocessor} generated 


972 HO NUCLEUS AREA IS TOO SMALL; IT IS NOT UPDATED. THIS NUCLEUS 
WOULD REQUIRE nnannnn {CYLINDERS|PAGES} 


973 HO No directory file on IPL volume volume 
974 HO No valid override file; using system defaults 


UC = upwardly compatible, IC = incompatible, HO = VM/SP HPO only. 
Not listed: compatible messages and VM/XA SP-only messages. 
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VM/XA SF Conversion 


Chapter 11. Overview: Systems Comparison 


This chapter compares VM/XA SP to VM/XA SF by providing: 


e A table summarizing compatibility 
¢ Greater detail for key items in the table 
e A list of new function. 


Summary of Compatibility between VM/XA SF Release 2 and VM/XA 


SP 


In general, VM/XA SP is upwardly compatible with VM/XA SF Release 2. Due to 
improvements in VM/XA SP’s compatibility with VM/SP HPO, some VM/XA SP 
CP externals (commands, DIAGNOSE codes, and messages) may not be the same as 
those in VM/XA SF. 


The CMS component in VM/XA SP is in general upwardly compatible with the 
CMS component in VM/SP Release 5. Since VM/XA SF Release 2 supports CMS 
at the VM/SP Release 4 level, you must evaluate changes between CMS at the 
Release 4 level and the Release 5 level. Refer to VM/SP Release 5 publications to 
make this evaluation. See VM/XA SP CMS Application Program Conversion Guide 
for information about converting your applications to the VM/XA SP level of CMS. 


Table 25 shows a summary of the compatibility between VM/XA SP and VM/XA 


SF Release 2. 


Table 25 (Page 1 of 2). Summary of Compatibility between VM/XA SF Release 2 and VM/XA SP 


VM/XA SF Release 2 Item VM/XA SP’s Support of the Item 


System/370 architecture 


CMS macros 
CMS external control blocks 


Programs using 24-bit 
addressing 


Programs written in high-level 
languages 


OS simulation services 


System/370 mode virtual machines are compatible with System/370 
architecture. 


Those minidisks that reside on VM/XA SP-supported devices can be 
used unchanged. 


All VM/XA SP CMS commands are compatible with VM/SP 
Release 5 except the DEBUG command. There are new CMS 
commands that invoke new function and there are enhanced 
commands to invoke enhanced function. The enhanced commands 
are upwardly compatible with VM/SP Release 5. 


CMS macros in VM/XA SP are upwardly compatible with VM/SP 
Release 5. 


CMS external control blocks in VM/XA SP are compatible with 
VM/SP Release 5. 


These programs continue to execute in virtual storage below 16Mb in 
System/370 or 370-XA mode virtual machines. 


For those languages that VM/XA SP supports, they are source-code 
compatible. You may need to recompile the programs. 


OS simulation is compatible with VM/SP Release 5 CMS. VM/XA 


SP adds MVS/XA macros. 
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Table 25 (Page 2 of 2). Summary of Compatibility between VM/XA SF Release 2 and VM/XA SP 


VM/XA SF Release 2 Item VM/XA SP’s Support of the Item 
DOS/VSE simulation | DOS/VSE simulation is compatible with VM/SP Release 5 CMS. 


Assembler application programs Assembler programs should execute without change. Exceptions 


could be programs that: 


Depend on internal CP or CMS structure or control blocks 
¢ Depend on functions that CP does not provide 

¢ Depend on incompatible CP externals 

e Depend on explicit System/370 architecture implementation. 


See Chapter 18, “Application Programming” on page 203. 


EXECs written in CMS EXEC, 
EXEC 2, or REXX 


Generally, these EXECs are upwardly compatible. However, EXECs 
that use CP commands or DIAGNOSE codes must be examined for 
compatibility. In particular, examine code that depends on CP 
return codes and responses. EXEC, EXEC 2, and REXX programs 
run only below the 16Mb line. 


Installing CMS on VM/XA SP is a similar, EXEC-driven procedure. 
CMS as a named saved system requires 2Mb of virtual storage. 


Installing CP Installing the VM/XA SP CP is compatible with installing VM/XA 
SF Release 2. 


| Installing CMS 


Installing user-written Installing user-written applications and licensed programs in VM/XA 
applications and licensed SP is similar to installing them in VM/XA SF Release 2. You can 
programs in shared storage continue to implement saved segments as you did in VM/XA SF. 


VM/XA SP allows you to pack many programs or data areas into 
one saved segment. 


Licensed programs You can find a list of supported licensed programs in VM/XA SP 
General information. 


Devices You can find a list of supported devices in VM/XA SP General 
Information. 


Spool files Programs that operate on spool files owned by another user must 
now refer to spool files by user ID and spool ID. CP spooling 

commands were enhanced for this support. You must use SPTAPE 
to transfer VM/XA SF spool files to VM/XA SP. 


VM/XA SP supports the GCS component, RSCS Version 2.2 or 
later, and SNA networking products such as ACEF/VTAM 3.1.1 or 
later and NetView™ Release | or later. 


Networking facilities 


User modifications to the system | You may have to rework any user modifications due to additional 
function added in VM/XA SP to the CCW translation function and 
the virtual interpretive-execution facility support code. These 
functions are object code only. Note that the Vector Facility 


support code is already object code only in VM/XA SF. 


NetView is a trademark of the International Business Machines Corporation. 
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Saved Segment Differences 


For ease of conversion from VM/SP HPO, VM/XA SP adopts a shared segment 
packing scheme over and above the DCSS scheme already implemented in VM/XA 
SF. You can put one or more programs or data areas into a single segment. The 
new shared segment support: 


e Allows a shared item to have page boundaries rather than segment (1Mb) 
boundaries 


¢ Allows segment packing, that is, two or more items per shared segment 


¢ Continues the VM/XA SF restriction that the 1Mb segment be either shared or 
exclusive 


| e Requires that you purge an existing named saved system (NSS) before you 
| define a new one with the same name. 


oe The new support adds segment spaces and member saved segments to the familiar 
| DCSSs. Table 26 outlines the attributes of all three. 


Table 26 (Page 1 of 2). Saved Segment Terminology 


Contains one or more 
megabytes of storage 


Beginning address is 
rounded down to the 
nearest megabyte 
boundary 


Ending address is 
rounded up to the 
nearest megabyte 

boundary 


Minimum size is 1Mb, 
regardless of how many 
pages are defined; 
maximum is 999Mb 


May span megabyte 
boundaries 


May be saved by name 
with the SAVESEG 
command 


May be loaded? by 
name with DIAGNOSE 
X'64' 

May be purged? by 
name 


Segment Space 


Contains one or more 
megabytes of storage 


Beginning address is 
rounded down to the 
nearest megabyte 
boundary 


Ending address is 
rounded up to the 
nearest megabyte 

boundary 


Minimum size is 1Mb, 
regardless of how many 
pages are defined; 
maximum is 999Mb 


May span megabyte 
boundaries 


May not be saved by 
name 


May be loaded? by 
name with DIAGNOSE 
X'64' 

May be purged? by 
name 


Member Saved Segment 


Contains one or more 
megabytes of storage 


Beginning address 
rounded down to a page 
boundary 


Ending address is 
rounded up to the last 
byte in the member’s 
last page 


Minimum size is 4K, 
maximum is 999Mb 


May span megabyte 
boundaries 


May be saved by name 
with the SAVESEG 
command 


May be loaded? by 
name with DIAGNOSE 
X'64' 

May be purged? by 
name 


2 Loading and purging may instead be done with the CMS SEGMENT command or SEGMENT macro. 
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Table 26 (Page 2 of 2). Saved Segment Terminology — 
DCSS _ Segment Space Member Saved Segment R vf 


Contains a single shared § Contains up to 64 Is associated with up to 
item member saved segments 64 segment spaces 


You do not have to adopt segment packing on VM/XA SP, since VM/XA SP allows 
you to continue to define shared segments the way you did on VM/XA SF. In fact, 
IBM recommends that you avoid segment packing, since there is additional CP 
overhead involved when you use it. For programs that use 31-bit addresses, there is 
no need to pack segments because you can use virtual storage addresses up to 
999Mb (the current maximum storage size of a virtual machine). CP does not fill in 
segment table entries between the highest virtual storage address of the virtual 
machine and the beginning of the shared segment, so no additional main storage is 
required for page tables. 


After you have converted to VM/XA SP, if you find you need to use segment spaces, ( 
refer to VM/XA SP Planning and Administration for information about how to 
create and manage them. 


The User Directory 


VM/XA SP allows you to place the user directory (that is, the output of the 

DIRECTXA command, also called the “object directory”) on any CP-owned 

volume. When CP initializes, it looks for a user directory on the system-residence 
volume first. If no user directory is there, CP follows the order of the list of a : 
CP-owned volumes on the SYSCPVOL macro instruction in its search for a user Me 7 
directory. CP selects the first directory it finds. If CP finds no user directory or an 

invalid user directory, CP logs on an operator to allow you to create a valid user 

directory. 


The Resource Access Control Facility (RACF) 


Though installing RACF on your system does not directly affect your immediate 
conversion to VM/XA SP from VM/XA SF, if you do install RACF take note of the P 


following: ~ 


¢ You can operate RACF in defer mode. This means that although RACF does 
authority checks, it issues only warning messages. Access to the resource is 
granted based on regular VM/XA SP access checks. Defer mode eases your 
conversion during the period immediately after you install RACF. 


After you have completed your conversion to RACF, you can operate RACF in 
full fail mode, which denies access to a resource when the RACF authority : 
check fails. If an RACF authority check succeeds, a command completes 
execution with no change. If the RACF authority check fails, the command 
terminates with a message. 


e End users are affected by RACF. For instance, RACF allows an end user to 
change the password during logon. Also, RACF does not immediately lock a 
user out of the system when the password expires. 
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The VM/XA SP Monitor and Monitor Writer Sample Program 


Block Paging 


The new system monitor does not directly affect your conversion to VM/XA SP. 
The following helps you plan for future use of the system monitor. 


You can use the MONITOR command to control the VM/XA SP monitor, which is 
a standard function in CP. The monitor collects performance data during VM/XA 
SP operation and stores it in the form of monitor records in a saved segment that 
you must define. The monitor writer sample program runs in a CMS virtual 
machine and uses the *MONITOR IUCYV system service to retrieve the records from 
the monitor saved segment and then stores them in a CMS file on disk or on tape. 
(Alternatively, you can write your own program to connect to “MONITOR and 
retrieve the records.) You must establish a program to read the generated file and 
perform data reduction on the performance data it contains. 


For more information about the VM/XA SP monitor, see the VM/XA SP Features 
Summary, VM/XA SP Planning and Administration, and VM/XA SP CP 
Programming Services. 


Block paging, an enhancement to VM/XA SF Release 2, is part of the VM/XA SP 
base. It is important to allocate as paging volumes two to four times the amount of 
DASD space assigned to all logged-on users on the system. 


Note also that, as you grant more virtual storage to users, you put a strain on the 
paging subsystem. 


Elimination of the Free Storage Area 


VM/XA SP eliminates a separate main storage area for free storage. Instead, free 
storage blocks are allocated from the dynamic paging area. Note that you still need 
at least as much dynamic paging area as the sum of VM/XA SP'’s free storage area 
and dynamic paging area. 


If you code the FREE parameter on the SYSSTORE macro in HCPSYS, an 
MNOTE is issued at assembly time and the parameter is ignored. This should not 
affect the system, since the dynamic paging area is automatically set to occupy the 
storage left unused by the V=R area, the V=R machine recovery area, the RIO370 
area, and the CP-resident nucleus. So, if the sum of your other storage areas 
remains constant, your dynamic paging area should be sufficient. 


Since you may be adding more users to your system, remember that each new user 
adds approximately four to five pages of free storage. Plan for your dynamic paging 
area accordingly. 


The Spool File Limit and Spool Files 


VM/XA SP allows each user up to 9999 spool files, essentially making the total 
number of spool files allowed in the system a function of the total system resources 
allocated to spooling. 
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The total number of files you can have in the system is determined by the size of the 
warm start area. Each DASD type can hold a specific number of pages per cylinder. a 
For instance, a 3380 holds 150 pages per cylinder, allowing nearly 154 000 files. See ( 
VM/XA SP Installation and Service for the number of pages you can fit on a 
cylinder of a specific DASD type. 


The total spooling space you need depends on the type of spool files you typically 
have. Small files such as PROFS notes typically use about two pages of DASD 
storage. Large files like listings, documents, and dumps require much more. Since 
trailing blanks are suppressed, “narrow” files of many lines require less space than 
“wide” files with right-hand margins, such as listings. Printer fonts are large and 
may consume space in environments that process sophisticated documents. A typical 
installation needs to allocate about 500 cylinders for spool space. See VM/XA SP 
Planning and Administration for details. | 


Your system operator receives a warning message when spooling space is nearly full. 

The operator can bring additional spooling volumes online if those volumes are i. 
defined on the SYSCPVOL macro and formatted with CPFORMAT. Otherwise, ( 
your operator should request that spool files be purged, processed, or put on tape ~ 
with the SPTAPE command. 


Because of the changes to the spool file system for VM/XA SP, you must perform a 
cold start of the system when bringing it up for the first time. You must process 
VM/XA SF spool files or use the SPTAPE command to preserve your VM/XA SF 
spool files. 


CMS Extended Data Array Capability (CMS/EDAC) a ‘ 


VM/XA SP does not support the CMS/EDAC program. You do not have to make 
any changes to your application source code, but you will need the new version of 
the FORTRAN compiler and library to get the same functions that you had with 
CMS/EDAC. 


General Changes to the Scheduler 


The VM/XA SF scheduler managed only processor resources. The VM/XA SP as 
scheduler manages storage and paging, as well, and improves the scheduling of ae 
processor resources. 


VM/XA SP improves VM/XA SF’s scheduling policies by introducing a working set 
size growth limit. This allows the scheduler to detect and control high storage 
consumers. In addition, VM/XA SP schedules work based on each user’s resource 
requirement, the current system resource load, and each user’s transaction 
characteristics. 


VM/XA SP improves the relation between scheduling and real storage management, 
thereby decreasing the likelihood that thrashing will occur. | 


VM/XA SP improves the handling of interactive users by implementing multiple 
classes of users within the eligible list. VWM/XA SP also uses interactive buffers for 
scheduled resources. An interactive buffer reserves some fraction of the system's 
resources for interactive transactions. You can tune the amount of reserved 
resources with the new VM/XA SP commands SET SRM STORBUEF and SET SRM 
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LDUBUF. VM/XA SP preempts long-running work with interactive work in 
extreme cases of storage contention. | 


In VM/XA SF, a share is applied to processor resources. VWM/XA SP creates shares 
for other resources as well, making ABSCPU (absolute CPU) an invalid type of SET 
SHARE option. VM/XA SP also improves the delivery of shares. VM/XA SF 
could not deliver shares whenever an eligible list formed, that 1s, whenever there was 
storage contention. VM/XA SP delivers shares both when an eligible list forms and 
when it does not. 


VM/XA SP considers Expanded Storage in its scheduling algorithms and implements 
a “QUICK DSP” (quick dispatching) function. QUICKDSP satisfies virtual 
machines with critical response time requirements. 


For an overview of the scheduler, see the VM/XA SP Features Summary. For 
information about how to tune your system, see VM/XA SP Planning and 
Administration. Chapter 14, “Administration” on page 181 discusses differences in 
command externals between the VM/XA SF and VM/XA SP schedulers. 


Multiple Preferred Guests 


V=F Machine 


VM/XA SP’s support for multiple preferred guests allows you to support up to six 

preferred virtual machines for production work, enabling you to consolidate several 
operating systems on one processor or to migrate operating systems to the 370-XA 

architecture while doing production work. The support has several new functions, 

including: 


e A new type of preferred virtual machine, the V=F machine 
e Changes to dedicated processor support 
e Changes to Expanded Storage support. 


The V=F machine is a new kind of preferred virtual machine. A V=F machine has 
a fixed, contiguous area of main storage, like a V=R machine, but, unlikea V=R 
machine, the storage area does not begin at page 0. The V=R area continues to be 
a single area that you specify at system generation time. CP allocates storage to 
V=R and V=F machines from the single V=R area as the machines log on. 


Usually, you determine how much storage a preferred virtual machine gets through 
the user directory. You also can alter the storage size of preferred virtual machines 
dynamically with CP commands. When a preferred virtual machine logs on, CP 
checks the user directory for the size of storage the preferred virtual machine 
requires and then attempts to allocate a contiguous piece from the V=R area. 
Provided this contiguous piece is available, CP assigns this storage area to that 
preferred virtual machine. If a contiguous piece of the V=R area is not available, 
CP logs on the virtual machine as a V=V machine. 


There are some differences between the storage that V=F machines get and the 
storage that the V=R machine gets. The V=R machine always gets the first 
megabyte of main storage, because it contains page 0. This means the storage for 
the V=R machine is allocated from the lowest storage address up. V=F machine 
storage is allocated from the highest available storage address in the V=R area 
down. If a V=R machine attempts to log on and page 0 is not available because 
another V=R machine ts already logged on, CP attempts to log on the virtual 
machine as a V=F machine. If a V=F machine tries to log on and the only 
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sufficient storage available includes page 0, CP logs on the virtual machine as a 

V=V machine. 7. * ae Cc 
Changes to Dedicated Processor Support | Wy 

You can now dedicate real processors and all or parts of Expanded Storage to any 

virtual machine on the system, V=V machines included. You can use directory 

control statements to control whether a virtual machine automatically gets a real 

processor dedicated to it at logon. 7 


Changes to Expanded Storage Support 
An enhancement to VM/XA SF allowed you to give CP and one virtual machine 
simultaneous access to Expanded Storage. VM/XA SP has this function in its base 
code. VM/XA SP, with the addition of support for multiple preferred guests, adds 
more to the Expanded Storage function. 


VM/XA SP allows you to divide Expanded Storage into multiple partitions for CP 
and virtual machines. That means more than one virtual machine as well as CP can 


use parts of Expanded Storage simultaneously. 4 a 


If you include Expanded Storage in a virtual machine configuration, CP attempts to 
allocate a contiguous part of Expanded Storage to the virtual machine when it logs 
on. If not enough Expanded Storage is available for that virtual machine, CP 
allocates the largest contiguous piece of Expanded Storage available. 


Though Expanded Storage dedicated to a virtual machine must be contiguous, CP 
can have multiple pieces of Expanded Storage. If, for instance, a virtual machine 
with Expanded Storage logs off the system, that partition of Expanded Storage is 
available for CP’s use. 
The new Expanded Storage support: 

e Has a size option on the ATTACH XSTORE command. 


e Adds a MAP option to the QUERY XSTORE command. This option requests 
a display of a map showing how Expanded Storage is currently allocated. 


The Effect of Multiple Preferred Guest Support 
You should consider the effect of the new V=F support on your installation’s | | 
resources. You should consider: Mico 


e Allocating a larger V=R region to accommodate V=F machines 
¢ Identifying operating systems that are candidates for V=F machines 


e Determining if real processors should be dedicated to one or more virtual 
processors in V=R, V=F, or V=V machines 


¢ Determining which users should have Expanded Storage attached 


e Determining how much Expanded Storage should be retained for CP’s exclusive 
use 


e Determining if you can merge V=R operating systems from other systems onto 
the single VM/XA SP system by putting them in V=F machines. 


One consideration directly affects your conversion. In VM/XA SF, if two virtual 
machines with Expanded Storage 1n their directory entries logged on, only the first 
one to log on got Expanded Storage. In VM/XA SP, both virtual machines can get 
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Expanded Storage. This could cause a problem for configurations that implicitly 
retain Expanded Storage for CP use by never attaching all Expanded Storage to a 
virtual machine. You may need to issue the RETAIN XSTORE command to avoid 
having virtual machines take all of Expanded Storage when you want to leave some 
for CP. 


New Allocation Map for 3380 Devices 


An enhancement to VM/XA SF included support for new 3380 devices that require a 
larger allocation map. For all 3380 devices, the allocation map is now 4K rather 
than 1K. VM/XA SP includes this change in the base code. This could create a 
problem for you if you reallocate 3380 devices while on VM/XA SP and then have 
to back out to a VM/XA SF system without the enhancement for 3380 devices. You 
can prevent this problem in either of two ways: 


¢ Make sure you install the enhancement for 3380 devices on your VM/XA SF 


( system. 
\.. ¢ Do not reallocate 3380 devices until you are sure you will not have to return to 
VM/XA SF. 


Four-Digit Message Numbers 


VM/XA SP has some messages with four-digit numbers in the message headers, thus 
allowing you to receive a message numbered up to 9999. For the sake of 
compatibility with VM/SP HPO and VM/XA SF, those messages that were 
previously three-digit continue to have the old message header format: 


CCCMMMNNNA 


New four-digit messages have the format: 
CCCMMMNNNNA | 


where: 


CCC 
( - is the component that issued the message. 


MMM 
is the module issuing the message. 


NNN 
NNNN 
is the three- or four-digit number. 


A 
is the action indicator. 


Some programs edit the error messages that they receive by using DIAGNOSE code 
X'5C'. The operation of DIAGNOSE code X'5C' remains the same as in VM/SP 
HPO for three-digit error messages. A new subfunction code has been added to 
DIAGNOSE code X'5C' for four-digit error messages. 


See “Changed DIAGNOSE Codes” on page 207 for more information about 
DIAGNOSE code X'5C' and “VM/XA SF and VM/XA SP Message 
Compatibility” on page 218 for more information about message compatibility. 


Chapter 11. Overview: Systems Comparison 157 


| VM/XA SF Conversion 


Object Code Only and New Service Procedures 


New Functions 


Modules in VM/XA SP are available as follows: 


¢ Some modules are available with machine-readable source code. For these 
modules, VM/XA SP uses new source service tools and procedures. 


¢ Some modules are object code only; that is, source code and accompanying 
source materials such as logic documentation are not available. See 
Appendix C, “Object-Code-Only (OCO) and Limited-Distribution Modules” on 
page 291 for a list of these modules. 


e Some modules have limited distribution; they are available as object code, and 
source code is available on microfiche. Thus, you have access to the source code 
but not in machine-readable form. See Appendix C, “Object-Code-Only (OCO) 
and Limited-Distribution Modules” on page 291 for a list of these modules. 


For the latter two categories, new service procedures help you service those functions 
of the system. The primary method for servicing object code is by replacing the 
object module (also called the text file). You can also perform temporary fixes on 
object modules using patches applied by the system loader. 


IBM has improved existing service tools for object code modules. The improvements 
make object code service similar to traditional VM source code service. Source code 
service procedures have also been improved. For more information on service, see 
“Differences Applying Service to the System” on page 179 and the VM/XA SP 
Installation and Service manual. 


in VM/XA SP 
New functions in VM/XA SP include: 


e A high-capacity CMS environment based on the VM/SP Release 5 CMS that 
supports large numbers of interactive users and 24- or 31-bit addressing 


¢ CMS functions such as DOS/VSE and OS/MVS simulation, RDRLIST, and 
SENDFILE ~ 


¢ Multiple preferred guests, provided you have the Processor Resource/Systems 
Manager (PR/SM) feature on your 3090 Model E processor 


¢ New IUCV CP system services such as *BLOCKIO, *RPI, *MONITOR, *CCS, 
*SIGNAL, and discontiguous buffer support 


e An increase of the spool file limit to 9999 spool files per user 

e A system monitor 

e The programmable operator facility 

e The single console image facility (SCIF) 

¢ The ability to change the command privilege class structure (UCR) 
¢ The ability to place a user directory on any CP-owned volume 

¢ System profiles (SYSPROF EXEC) 


e A protected application environment (also called the protected end-user 
environment) | 
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¢ Logged-on user limit changes 


¢ Universal character sets and forms control buffers for impact printers held in 
image libraries, similar to 3800 image libraries 


e First failure data capture for CMS 
e Control block identifiers in free storage blocks 
¢ Four-digit message numbers for some messages 


¢ Increased command, DIAGNOSE code, and message compatibility with VM/SP 
HPO Release 5 


e An improved system scheduler 
¢ Use of the software last-translated address look-aside buffer 
e Faster module linkage code paths 
| ¢ Additional device support 
( e Shared segment packing 

| ¢ The GCS component and SNA networking 

| e SPTAPE multivolume capability 

| ¢ Enhanced diagnostic facilities 

| ¢ Enhancements to the dump viewing facility 

| e Additional soft abend dump capability 


( : | e Expanded Storage caching capability for virtual machine logon, IPL, and CMS 
i | system minidisks 


| ¢ Automatic deactivation of restricted passwords 


| ¢ The capability to update the CP directory without having to rebuild it. 
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Chapter 12. Planning for Conversion 


Developing a Conversion Plan 


A conversion plan is the key to a successful conversion to VM/XA SP. Planning 
should begin early, ideally as soon as you make the decision to order VM/XA SP. 
To begin your plan, take inventory of your current system hardware and software, 
and then establish goals for what your new system environment will contain. 


Planning for the conversion is the process of organizing the conversion project in 
such a way as to produce a new system that meets requirements set by your 
installation. 


Key points you have to consider for conversion planning are: 


1. Develop a statement of purpose for your system conversion. 


The goals for conversion set boundaries on the conversion process and help you 
put a plan in place that meets your requirements. 


2. Understand the conversion requirements. 
These include: 


¢ Technical requirements. What is the technical goal for the new system? For 
example, your goal might be to remove storage constraints for applications. 


e Schedule. When do you expect the conversion to be complete? A 
conversion takes about the same amount of time as a release-to-release 
migration. 


e Human resources. How many people do you need to perform the 
conversion? It is best to have one person coordinate the conversion. The 
number of other people involved varies from installation to installation and 
is based on the complexity of the system, the experience of the personnel, 
the number of applications, and many other factors. Remember to have 
backups for key people. 


e Cost. What is the acceptable limit to the conversion expense? 


¢ Workload. What is the maximum workload given current resources? Are 
additional resources needed? 


3. Establish or update your system technical inventory. 


You should begin your conversion with an accurate inventory of all the elements 
of your system. Make a list of: 


-¢ Hardware configuration. This should reflect what is already installed plus 
any hardware you plan to install or remove during the conversion tiine 
period. 


e Software products. This should include all installed IBM and vendor 
programs that are used on your current system. 


e Applications. You should make an inventory of all applications on your 
VM/XA SF system, especially those that use CP and CMS interfaces such as 


Chapter 12. Planning for Conversion 161 


VM/XA SF Conversion 


CP commands, DIAGNOSE codes, messages, CP control blocks, CP 
macros, CMS macros, and CMS control blocks. 


e System modifications. This should include any changes you have made to “oe e 
code provided by IBM. You may have to change these modifications. 


e User-installed tools. 


4. Determine which licensed programs, applications, and modifications are necessary 
and which ones can be replaced or eliminated. 


To find out which programs are used and how often they are used, you can 
either survey your end users or set up an automated procedure. One way to 
automate the procedure is to add a statement to the beginning of each EXEC, 
program, or macro that sends a message using the *MSG IUCV system service 
to a service machine. The service machine will thus record the number of times 
an application is called. 


e Refer to VM/XA SP General Information or contact your IBM 
representative for a list of IBM licensed programs supported by VM/XA SP. fe 
Determine if these programs offer sufficient functions for your production \ 
system. Determine the impact of the functions that are not supported. 
Order the correct level of the programs that you need, and order any 
prerequisites or corequisites if you do not already have them. 


¢ Contact other software companies about non-IBM products. 


¢ Determine the impact of converting necessary applications and 
modifications. 


5. Identify specific users or groups of users who will benefit from converting to 
VM/XA SP and the order in which you will convert them. 


= 


Also, identify users who cannot convert to VM/XA SP because they require 
programs that are not supported. Plan what you will do with these users; for 
example, consider moving them to a system that is not yet targeted for 
conversion. | 


6. Evaluate your service agreements with your end users. 


Can you negotiate for different reliability and availability criteria during the 
conversion period? Also, you may want to warn end users that availability 
means that the system is up, not that all applications are necessarily working. 


7. Understand the impact of major items that are handled differently in VM/XA SP. 
| These items include: 


e Scheduler changes 

¢ Logged-on user limit changes 

e Printer support changes 

¢ Spool file limits and format changes. 


These items, as well as other major differences between VM/XA SF and VM/XA 
SP, are discussed in Chapter 11, “Overview: Systems Comparison” on 
page 149. 


8. Educate the staff about VM/XA SP. 
Key personnel who need education are: 


¢ Planners, who require information about what hardware and software is 
supported by VM/XA SP 
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¢ Support Personnel, who require information about new VM/XA SP system 
internals 


¢ System administrators, who require information about new and changed 
procedures for controlling system resources 


¢ Application Programmers, who require information about VM/XA SP 
application programming interfaces 


¢ End users, who require information about VM/XA SP commands that are 
different from VM/XA SF. See Chapter 17, “Application End Use” on 
page 201 for a list of these commands. 


Order an adequate supply of manuals. See “VM/XA System Product 
Publications” on page 305 for titles and order numbers. 


For information about education that IBM offers, contact your IBM 
representative. 


It is important that managers, ‘support personnel, system administrators, 
application programmers, and end users understand the changes that will occur 
when your installation converts to VM/XA SP. An understanding of your 
installation’s goals, the benefits of VM/XA SP, and the changes required to 
convert to VM/XA SP will help your organization commit to the project. 


. Create a detailed conversion plan. 


This plan should provide a detailed map of the activities and schedules needed to 
complete a successful conversion. Develop strategies for how you will approach 
the conversion. You must determine: 


¢ Groups of work items that can be combined and managed together. 
e A beginning and an end date for each work item. 


e A reporting structure for managing the conversion process, that is, how each 
member of the conversion team reports progress to the person responsible 
for the entire conversion. 


e A strategy for testing the new system during conversion and when the 
conversion is complete. Because you have a production VM/XA SF system 
operating during the conversion, the strategy you create must answer 
questions like: 


— How will I convert to VM/XA SP while running production on VM/XA 
SF at the same time? 


— How will I arrange networking during the conversion? 
— What is the best way to build and test VM/XA SP? 


For guidance on some of these questions see “Conversion Strategies” on 
page 164. 


10. Create a back off plan. 


I]. 


Determine back off criteria, plans, and schedules. 
Understand how application programs need to be changed to run in VM/XA SP. 


IBM provides a sample EXEC, called COMPSCAN SAMPEXEC, that can help 
you determine how much work you need to do to convert programs to run on 
VM/XA SP. For more information, see Chapter 18, “Application 
Programming” on page 203 and Appendix A, “Conversion Tools” on 

page 277. 
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12. Communicate. 


Before converting, communicate the conversion plan to the users of your current {~ 
system. During the conversion, communicate the status of the conversion to the : 
users of your new system. 


Inform your users of the justifications for the conversion, the benefits of the new 
system, the dates for the main tasks in your conversion plan, the system 

resources that will be unavailable at certain times, and what your users’ role is in 
the conversion process (that is, testing their individual applications and EXECs). 


Because much of the impact of the conversion is to applications and EXECs, 
you should involve application programmers in the conversion. They will have 
to check their applications and EXECs, recode them if changes are required, and 
test them. Involve end users, too, because the externals of some system 
functions may change. For instance, the logon procedure changes if you install 
RACF on the new system. 


Some forms of communication are: 
e Classroom education 
e User service representatives 


e A bulletin board facility or conferencing system, which could be 
implemented in several ways: 


— As read-only or help files that users can browse. 


— Asa disconnected virtual machine to which users can submit questions 
and comments that are available for all to read and respond to. The 
questions and comments would reside in files, and users would link with ers 
read access to the minidisks containing these files. As users submit their ‘ 
questions or comments (updates), the disconnected virtual machine 
would append the updates to the appropriate file based upon file name 
or file type. 


Conversion Strategies 


This section gives you an outline of general procedures for conversion from VM/XA 
SF to VM/XA SP. For the most part, conversion from VM/XA SF Release 2 to 
VM/XA SP is like a release conversion, since VM/XA SP is so similar to VM/XA See asl 
SF. - 

The strategy you adopt for conversion depends on the hardware resources you have 
available. If you have a test processor available, follow the procedure outlined in 

“Using Two Processors.” If you do not have a test processor, follow the procedure 

outlined in “Using One Processor” on page 167. Remember that throughout the 

conversion your VM/XA SF system itself provides an excellent conversion tool, since 

you can install and do early testing of VM/XA SP on it. 


Using Two Processors 
You may be able to devote a processor complex to the task of converting VM/XA 
SF to VM/XA SP. This strategy assumes you have a test processor available or can 
balance your other production systems to free up a processor for test purposes. For 
ease of performing the testing, the test processor should have a network connection 
with your present VM/XA SF system. The network connection allows you to 
transfer files easily from the VM/XA SF system to VM/XA SP. This is important 
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especially for transferring applications to the new VM/XA SP system for testing. 
oe Figure 16 on page 166 depicts this conversion strategy as a series of phases. 
( Here are the general steps: 


1. Build the VM/XA SP system in a virtual machine on your VM/XA SF system. 
The VM/XA SP Installation and Service manual and the VM/XA SP Program 
Directory describe methods for building VM/XA SP. You may want to create a 
new VM/XA SF user ID for the VM/XA SP system. (For instance, create a 
user ID called MAINTSP.) Be sure to build VM/XA SP on its own system 
residence DASD. Do this by dedicating a full DASD pack to the virtual 
machine. 


You may want to build a “one-pack system” (a minimum system), which is a 
complete VM/XA SP system on one DASD. Though you may not be able to 
run an entire production system with this one-pack system, you can use it to test 
an early version of VM/XA SP. Later, you can generate your production 
VM/XA SP system. If you do create a one-pack system, be sure to allocate all 
Mae CP areas on the pack, including the directory area and the spooling area, which 
( usually do not have to reside on the system residence volume. Since CP can use 
spooling areas for paging, you are not required to allocate a paging area. 


2. Since you are replacing your VM/XA SF system with VM/XA SP, you probably 
want to duplicate the real I/O configuration file (HCPRIO), system definition 
file (HCPSYS), and user directory file. You can do this by simply copying those 
source files from VM/XA SF, modifying them if necessary, then building the 
VM/XA SP system. 


For more information about changes to these files, see Chapter 13, “Installation 
and Service” on page 177 and Chapter 14, “Admunistration” on page 181. 


( 3. If you do work through remote 3270 access or plan on sending files across the 
network, modify the network node IDs of the VM/XA SP system. Create new 
node IDs for RSCS and VM/Pass-Through. This will be useful for sending files 
and accessing the VM/XA SP system running in the virtual machine. Build a 
virtual channel-to-channel adapter between the RSCS and VM/Pass-Through 
virtual machines on VM/XA SF and those on the VM/XA SP test system. Then 
you can pass files between systems or log on to VM/XA SP using remote display 
access. Later on, when VM/XA SP is running on the test processor, you can 

es replace the virtual channel-to-channel adapter with a real one (or use 37xx 
( connections) so the VM/XA SF and VM/XA SP systems can transfer files. 


4. After you have tested the VM/XA SP system in a virtual machine and feel the 
system is stable, move VM/XA SP to the test processor. There are a few ways 
you can do this. For instance, you can use DDRXA to dump VM/XA SP to 
tape and transfer the VM/XA SP system to DASD connected, to the test 
processor. Or you may be able to switch the VM/XA SP system residence 
DASD to the test processor physically. 


5. Do a hardware load (IPL) of the VM/XA SP system on the test processor. Note 
that at this point there should be no end users who will log on the system. 
System support personnel will use the system first to test system-related 
programs and EXECs. 


6. Bring up and test service virtual machines such as the accounting, error 
recording, and monitor machines. 
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Phase 1. Current VM/XA SF system 
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aa * 
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—_ 
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Figure 16. Converting from VM/XA SF to VM/XA SP Using Two Processors 
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7. Test applications such as IBM licensed programs, vendor programs, 
installation-written programs, and programming tools that your production _ 
system uses. You may need to have application programmers log on to the ~ 
system to test these applications. If you have to modify your applications to run 
on VM/XA SP, be sure to keep the VM/XA SF version for back up purposes. 


You may want to plan to convert applications in stages. You can begin with a 
representative sample of applications. After converting this sample, you can 
estimate the amount of time and effort it will take to complete all your 
application conversions. 


For more information about applications, see Chapter 18, “Application 
Programming” on page 203. 


8. Once applications are tested, have a limited number of application end users 
actually run the applications to see if they function properly. 


9. Once applications are thoroughly tested by end users, move the system to your 
=. production system. You must process all your VM/XA SF spool files or use the 
( SPTAPE command to save your VM/XA SF spool files on tape before you shut 
ae down VM/XA SF. Then you can do a hardware load (IPL) of VM/XA SP and 
restore, using SPTAPE, any VM/XA SF spool files you saved on tape. 


10. You may want to introduce the VM/XA SP system as your production system 
for limited periods, then return to the VM/XA SF system. For instance, you 
could bring up VM/XA SP during off-shift hours or weekends when there are a 
limited number. of end users on the system. After these limited periods, return to 
VM/XA SF and evaluate the VM/XA SP system. When you are satisfied that 
VM/XA SP is ready for full production, bring up VM/XA SP during an off-shift 
pe or weekend and keep the system running during prime shift operations. When 
( a moving from VM/XA SP to VM/XA SF or vice versa, be sure to process all 
spool files or use the SPTAPE command to save and restore your spool files. 


nr 


11. After you make the VM/XA SP system your production system, do not forget to 
change the node IDs for RSCS and VM/Pass-Through on the VM/XA SP 
system to match what you used for VM/XA SF. 


Using One Processor 
If you cannot devote a processor complex to testing VM/XA SP, you can bring up 
a VM/XA SP on VM/XA SF and test it. This strategy allows you to install and test 
( the CP component of VM/XA SP in a virtual machine. When you are satisfied that 
the CP component of VM/XA SP 1s stable, you can shut down VM/XA SF and 
bring up VM/XA SP. 


Figure 17 on page 168 depicts this conversion strategy as a series of phases. 
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Phase 1. Current VM/XA SF system 
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Phase 3. New VM/XA SP system 


V=R 
Machine 


VM/Pass- 
Through 


VM/Pass- 
Through 


V=R 
machine 


VM/Pass- 
Through 


VM/XA SP 
CMS 


— | VM/XA SP control program | 


Figure 17. Converting VM/XA SF to VM/XA SP Using One Processor 


1. Build the VM/XA SP system in a virtual machine on your VM/XA SF system. 
The VM/XA SP Installation and Service manual and the VM/XA SP Program 
Directory describe methods to build VM/XA SP. You may want to create a new 
VM/XA SF user ID for the VM/XA SP system. (For instance, create a user ID 
called MAINTSP.) Be sure to build VM/XA SP on its own system residence 
DASD. Do this by dedicating a full DASD pack to the virtual machine. 
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You may want to build a “one-pack system” (a minimum system), which is a 
complete VM/XA SP system on one DASD. Though you may not be able to 
run an entire production system with this one-pack system, you can use it to test 
an early version of VM/XA SP. Later, you can generate your full production 
VM/XA SP system. If you do create a one-pack system, be sure to allocate all 
CP areas on the pack, including the directory area and the spooling area, which 
usually do not have to reside on the system residence volume. Since CP can use 
spooling areas for paging, you are not required to allocate a paging area. 


. Since you are replacing your VM/XA SF system with VM/XA SP, you probably 


want to duplicate the real I/O configuration file (HCPRIO), system definition 
file (HCPSYS), and user directory file. You can do this by simply copying those 
source files from VM/XA SF, modifying them if necessary, then building the 
VM/XA SP system. 


For more information about changes to these files, see Chapter 13, “Installation 
and Service” on page 177 and Chapter 14, “Administration” on page 181. 


. If you do work through remote 3270 access or plan on sending files across the 


network, modify the network node IDs of the VM/XA SP system. Create new 
node IDs for RSCS and VM/Pass-Through. This will be useful for sending files 
and accessing the VM/XA SP system running in the virtual machine. Build a 
virtual channel-to-channel adapter between the RSCS and VM/Pass-Through 
virtual machines on VM/XA SF and those on the VM/XA SP test system. Then 
you can pass files between systems or log onto VM/XA SP using remote display 
ACCESS. 


. Test the VM/XA SP CP. Make sure it functions the way your present VM/XA 


SF system does. You can install licensed programs and installation-created 
programs while the VM/XA SP CP is tested in a virtual machine. Note that you 
cannot have the best performance from VM/XA SP when it runs in a V=V test 
machine, but at this point only your support personnel should be logged onto 
VM/XA SP. | 


. You may want to test some applications while VM/XA SP is running in a virtual 


machine. For instance, you may test a representative sample of your 
applications and evaluate how long it will take to convert all your applications. 


. While the VM/XA SP CP is running in a virtual machine, you may want to 


convert applications from the VM/XA SF CMS to the VM/XA SP CMS. In 
this way, there will be little interruption in service to end users when you shut 
down VM/XA SF and make VM/XA SP your production system. 


You may want to plan to convert applications in stages. You can begin with a 
representative sample of applications. After converting this sample, you can 
estimate the amount of time and effort it will take to complete all your 
application conversions. 


For more information about applications, see Chapter 18, “Application 
Programming” on page 203. 


. After testing the VM/XA SP CP, choose a good time to shut down the VM/XA 


SF system and bring up VM/XA SP. That time may be off-shift or on a 
weekend, when there may be some users on the system but not the entire user 
community. Bring up VM/XA SP during this time and test it for stability. You 
must process all your VM/XA SF spool files or use the SPTAPE command to 
save your VM/XA SF spool files on tape before you shut down VM/XA SF. 
Then you can do a hardware load (IPL) of VM/XA SP and restore, using 
SPTAPE, any VM/XA SF spool files you saved on tape. 
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8. When you are satisfied that the VM/XA SP CP component is stable, complete 
converting applications from the VM/XA SF CMS to the VM/XA SP CMS. If 
you had to modify your applications to run on VM/XA SP, be sure to ep the 
VM/XA SF version for back up purposes. 


9. When you are satisfied that your VM/XA SP production system is stable, keep it 
running during prime shift hours with the entire user community. If you need to 
return to VM/XA SF, be sure to process all spool files or use the SPTAPE 
command to save spool files. Then when you bring up VM/XA SF, use 
SPTAPE to restore your spool files. 


10. After you make the VM/XA SP system your production system, do not forget to 
change the node IDs for RSCS and VM/Pass-Through on the VM/XA SP 
system to match what you used for VM/XA SF. 


For information about alternative conversion strategies that include the use of 
unsupported system environments, see Appendix B, “Alternative Conversion 
Strategies” on page 289. 


What If | Have a Guest Operating System Running on VM/XA SF? = 
If you have a guest operating system, such as MVS, running on VM/XA SF, plan on 
moving it directly to VM/XA SP. You will get much better performance running the 
guest in a VM/XA SP virtual machine than you would if you ran the VM/XA SF 
system in a virtual machine and attempted to run EOUE MVS guest in a virtual 
machine on VM/XA SF. 


What about Sharing Data During the Conversion? - 
You may need to share data between VM/XA SF and VM/XA SP during the —_ 
conversion. For instance, you may want to test a CMS application on VM/XA SP eed 
and use data that is maintained on VM/XA SF. Since CMS does not support 
reserve/release, you cannot benefit from VM/XA SP’s concurrent virtual and real 
reserve/release. That is, you cannot have more than one CMS virtual machine 
writing to the same minidisk at the same time. For such a case, you can: 


¢ Replicate the data. This may be suitable if the data does not change frequently 
and you have the DASD space to spare. 

e Allow only one CMS virtual machine to write to the minidisk and all others to 
read from it but not write to it. This involves a data integrity exposure if one 
virtual machine is updating the minidisk while others are reading from it. ee 


The way you allow CMS virtual machines on VM/XA SF to share data with CMS 
virtual machines on VM/XA SP depends on whether one operating system is the 
guest of another. 


Case 1. For example, say you are running VM/XA SP as a guest of VM/XA SF and 
you want to share a minidisk between CMS virtual machines on both systems. 
Figure 18 on page 171 is a diagram showing the example. 
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Figure 18. Sharing DASD between Multilevel CMS Virtual Machines 


On the VM/XA SF system: 


1. Give one CMS virtual machine on VM/XA SF write access to the minidisk, for 
instance, Z in the diagram. Use the MDISK user directory statement. 


2. Give other CMS virtual machines on VM/XA SF (X and Y) read-only links to 
the minidisk. You can do this in two ways: 


¢ To define a link permanently, code a LINK statement for each virtual 
machine in its directory entry. 
¢ To define a link temporarily, use the LINK command. 


3. Define a link from the minidisk in question to the virtual machine in which 
VM/XA SP is running. You can do this in two ways: 


¢ To define a link permanently, code a LINK statement for the virtual 
machine in its directory entry. 


¢ To define a link temporarily, use the LINK command. 


Be sure to give VM/XA SP read-only access. 


On the VM/XA SP system running in a virtual machine: 


1. Code an RDEVICE macro in HCPRIO for the linked minidisk. Use VM/XA 
SP’s minidisk address—remember, it appears as a real device address to the 
VM/XA SP CP. 


2. Code the volume identifier for the linked minidisk on the SYSUVOL macro in 
HCPSYS. This identifies the volume to VM/XA SP as a volume with user 
minidisks. 


3. Code an MDISK statement for one user ID on the VM/XA SP system, for 
instance, virtual machine A. Give A read-only access to the minidisk. This 
assures virtual machine A does not try to write to the minidisk. 
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4. Give other virtual machines (B and C) links to A’s minidisk. You can do this in 
two ways: 


¢ To define a link permanently, code a LINK statement for each virtual 
machine in its directory entry. 


¢ To define a link temporarily, use the LINK command. 
Case 2. Let us say you are running VM/XA SP and VM/XA SF systems on separate 


processors and you want to share a minidisk between CMS virtual machines on both 
systems. Figure 19 is a diagram showing the example. 


CMS | CMS | CMS 
A B Cc 


VM/XA SF | VM/XA SP 
fo 
f : 


Figure 19. Sharing DASD between CMS Virtual Machines on Multiple Systems 


This case assumes you can physically attach the DASD so both processors can 
access it. 


On the VM/XA SF system: 
1. Code an RDEVICE macro in HCPRIO for the DASD. 


2. Code the volume ID for the DASD on the SYSUVOL macro in HCPSYS. This ( a 
identifies the volume to VM/XA SF as a volume with user minidisks. Me a 


3. Code an MDISK statement for one user ID on the VM/XA SF system that has 
write access to the DASD. For instance, this user ID could be Z. 


4. Give other virtual machines (X and Y) links to Z’s minidisk. You can do this in 
two ways: 


e To define a link permanently, code a LINK statement for each virtual 
machine in its directory entry. 


e To define a link temporarily, use the LINK command. 


On the VM/XA SP system: 
1. Code an RDEVICE macro in HCPRIO for the DASD. 


2. Code the volume ID for the DASD on the SYSUVOL macro in HCPSYS. This 
identifies the volume to VM/XA SP as a volume with user minidisks. © 
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3. Code an MDISK statement for one user ID on the VM/XA SP system, for 
instance, virtual machine A. Give A read-only access to the minidisk. This 
ensures that virtual machine A can not write to the minidisk. 


4. Give other virtual machines, B and C, links to A’s minidisk. You can do this in 
two ways: 


¢ To define a link permanently, code a LINK statement for each virtual 
machine in its directory entry. 


¢ To define a link temporarily, use the LINK command. 


How Do | Use VM/Pass-Through to Connect Virtual Machines? 
Using VM/Pass-Through, you can attach terminals to several VM operating systems. 
These operating systems can be on the same processor or on different processors. 
You achieve this by dialing local 3270s to a VM/Pass-Through service machine on 
one system using the DIAL command and then connecting to a VM/Pass-Through 
rr service machine on a second system. As a result, a virtual machine user who is 
( | connected to the first system can log on to the second system. 


From the end user’s point of view: 
1. The user finds a terminal with a local VM logo. The user types DIAL PVM. 


2. VM/Pass-Through responds by displaying a panel with a number of potential 
nodes. The user selects the VM/XA SP target node. 


3. When the VM/XA SP logo appears, the user can log on and during the session 
appears to be logically attached to the second system. 


( : The connection between VM/Pass-Through and virtual machines is achieved through 
- CP’s logical device support facility (LDSF). Within the same system, you can 
connect two VM/Pass-Through service machines using a virtual CTCA as shown in 
Figure 20. 


VM/XA SF 


Figure 20. Using VM/Pass-Through to Connect Virtual Machines on One System 


You can make the connection between two VM/Pass-Through service machines on 
separate processors by using a real CTCA or telecommunication controllers, as 
shown in Figure 21 on page 174. 
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Figure 21. Using VM/Pass-Through to Connect Virtual Machines on Two Systems 


Because of a restriction in the logical device support facility, the VM/Pass-Through 

service machine can only support up to 512 virtual machines. If you have more than | 
512 users on either your VM/XA SF or VM/XA SP system, you will need more than f 
one VM/Pass-Through service machine on that system. _ i Ne a” 


VM/Pass-Through Release 3 incorporates the VM/XA Migration Aid Remote 3270 
Display Option. If you have VM/Pass-Through Release 3, you no longer need the 
Remote 3270 Display Option licensed program. 


How Do | Use RSCS to Communicate between Virtual Machines? 
Using the Remote Spooling Communications Subsystem (RSCS) Networking 
licensed program, virtual machines can communicate with other virtual machines aa 
either on the same system or on separate VM systems. 


RSCS Version 2 requires the group control system (GCS), a component of VM/XA 
SP, and can communicate with RSCS Version 2 or with RSCS Version 1 via a 
virtual or real channel-to-channel adapter (CTCA). Over an SNA network, RSCS 
Version 2 can communicate with RSCS Version 2 but not with RSCS Version 1. 


Figure 22 shows RSCS Version 2 running in a virtual machine on VM/XA SP and 


connected through a virtual channel-to-channel adapter to an RSCS Version 1 
virtual machine eae on VM/XA SF. 


RSCS | CMS! CMS 
poe 
RSCS| CMS | CMS 
pacer 
| fmnxase SP 


coc" aaa 
VM/XA SF 


Figure 22. Connections between Multilevel RSCS Virtual Machines 
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Figure 23 on page 175 shows two RSCS virtual machines, each running on separate 
processors, using a real CTCA adapter to access each other. 


RSCS 
Version| CMS | CMS 
2 


RSCS 
Version 


i VM/XA SF 


CTCA 
or 37x5 


GCS 


VM/XA SP 


( Figure 23. Two RSCS Virtual Machines on Separate Processors 


What Should | Consider in My Back-Off Plans? 
When planning your migration to VM/XA SP, you must also plan how you will 
back off if you run into a problem. You will need two types of back-off plans: one 
for system problems and one for virtual machine problems. 


You need the system back-off plan when you run into a problem with VM/XA SP, 
such as an abend from which you cannot recover. In this case, you will need to be 
( * able to quickly re-IPL a VM/XA SF system. 


You need the virtual machine back-off plan when a user or group of users cannot 
run on VM/XA SP, for example, if application programs will not operate on the 
VM/XA SP CMS. In this case, you must quickly move the user or group of users to 
a VM/XA SF system. 


Once you determine your back-off plan, negotiate back-off criteria with your end 
users. Publish the approved plan. 


( Backing Off because of System Problems 

ae If you run into a problem with VM/XA SP that forces you to back off and you have 
not yet exploited VM/XA SP-only functions or migrated CMS users, the back off 
will only affect system availability. If, on the other hand, you run into a problem 
and have to back off after you have migrated CMS users, you will greatly affect 
these users. Once users convert their applications to run on the VM/XA SP CMS, 
they may not be able to run these applications on the VM/XA SF CMS. One 
solution is to duplicate the VM/XA SF versions of the applications and use those 
versions. In general, however, you should not migrate users to VM/XA SP until you 
are satisfied with its reliability. 


Throughout the conversion effort, you should maintain your VM/XA SF system 
residence volume and CP-owned packs. Then, if you need to back off, you can 
easily do so. Plan to build a small, one-pack VM/XA SP system. Once you have 
fully tested VM/XA SP, you can generate a larger system. 
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If you must back off from VM/XA SP and IPL a VM/XA SF system and you have 
maintained the VM/XA SF system residence volume and CP-owned packs, do the 
following: | — | , | 


1. SPTAPE DUMP VM/XA SP spool files. 

. Shut down the VM/XA SP system. 

3. IPL VM/XA SF. 

4. SPTAPE LOAD VM/XA SP spool files onto VM/XA SF. 


bo 


The important step here is to use SPTAPE to ensure that you do not lose spool files. 
You must SPTAPE DUMP the spool files so that you can restore them to your 
VM/XA SF system. 


The VM/XA SP SPTAPE command dumps files in VM/XA SF format; therefore, 
you do not need to worry about the differences in spool file format between VM/XA 
SF and VM/XA SP. 


Let us assume you run into a problem that prevents you from using SPTAPE. For 
instance, VM/XA SP abends and you cannot recover. In such a case, you can bring 
up VM/XA SF, diagnose the VM/XA SP problem in a virtual machine, and fix the 
problem on VM/XA SP. Then you can shut down VM/XA SF, reload (IPL) 
VM/XA SP with a warm start, and recover without losing spool files. 


Backing Off Individual Users because of Problems with Application Programs 


Once the system is stable, you will begin to convert CMS users. To prepare for a 
possible back off, either rewrite programs to execute in either architectural mode or 
keep copies of the System/370 versions of applications. To back off, do the 
following: 


1. SPTAPE DUMP VM/XA SP spool files. 

2. Shut down the VM/XA SP system. 

3. IPL VM/XA SF.) | 

4. SPTAPE LOAD VM/XA SP spool files onto VM/XA SF. 


You must SPTAPE the user’s or group of users’ spool files and restore them to the 
VM/XA SF system. 
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( Chapter 13. Installation and Service 


Installation and service tasks include tailoring system generation files, generating the 
system, and applying service to the system. 


You should install your VM/XA SP system by using the starter system. You could 
instead start with your existing VM/XA SF system, but this is a more difficult 
procedure than using the starter system. VM/XA SP Installation and Service 
includes a procedure for installing VM/XA SP in a virtual machine on a VM/XA SF 
system as well as the procedure for installing VM/XA SP on a separate processor. 


Differences Defining Real I/O 


( % Defining I/O for the 370-XA Channel Subsystem 


Defining Printers 


Pea 


Defining Spooling 


You can use the same IOCP files for VM/XA SP that you used for VM/XA SF. 


Because universal character sets and forms control buffers for impact printers are 
now installed in image libraries, VM/XA SP deletes HCPFCB, HCPUCC, 
HCPUCB, and HCPUCS. This means you have to use the IMAGELIB command 
to install universal character sets and forms control buffers for impact printers. 


VM/XA SP adds a new version of the FCB macro for the extended 4248 forms 
control buffers (FCBs). If the new features of the 4248 printer are not needed, you 
do not need to recode the macro. 


The RDEVICE macro now recognizes the 3262, 4245, and 4248 printers. The 
IMAGE operand now supports all impact printers, including the 1403, 3203, and 
3211. You do not need to recode the RDEVICE macros for impact printers unless 
you have a custom image library for the device. IBM supplies standard FCBs and 
character sets for all printers and the RDEVICE macro uses the IBM-supplied 
names as a default. For instance, the 1403 printer has the default image library 
IMAG1403 and the 4248 has IMAG4248. 


The UCSI macro creates a 12-byte header record that the LOADBUF and START 
commands use to load the printer buffer. The macro is a combination of the UCB, 
UCC, and UCS macros. These latter macros are maintained for compatibility. 


The UCSICCW macro creates a CCW string to print the buffer load image when an 
operator specifies the VERify option on the LOADBUF command. The macro 1s a 
combination of the UCBCCW, UCCCCW, and UCSCCW macros. These latter 
macros are maintained for compatibility. 


The total number of files you can have in the system is determined by the size of the 
warm start area. Each DASD type can hold a specific number of pages per cylinder. 
For instance, a 3380 holds 150 pages per cylinder, allowing nearly 154 000 files. See 
VM/XA SP Installation and Service for the number of pages you can fit on a 
cylinder of a specific DASD type. 


The total spooling space you need depends on the type of spool files you typically 
have. Small files such as PROFS notes typically use about two pages of DASD 
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storage. Large files like listings and documents require much more. Since trailing 

blanks are suppressed, “narrow” files of many lines require less space than “wide” con 
files with right-hand margins, such as listings. Printer fonts are large and may iy 
consume space in environments that process sophisticated documents. 


Your system operator will receive a warning message when spooling space is nearly 
full. The operator can bring additional spooling volumes online if those volumes are 
defined on the SYSOWN macro. Otherwise, your operator should request that 
spool files be purged, processed, or put on tape with the SPTAPE command. 


Differences Defining Main Storage 


Defining Free Storage 
VM/XA SP does not allocate a free storage area, so, if you continue to code the 
FREE parameter on the SYSSTORE macro in HCPSYS, an MNOTE is issued at ; 
assembly time and the parameter is ignored. You still need a dynamic paging area - 
that is equal to the total of the VM/XA SF free storage area and the VM/XA SF sae 
dynamic paging area. Continuing to code the FREE parameter should not affect the 
system, since the dynamic paging area is automatically set to the storage not used by 
the V=R area, the V=R machine recovery area, the RIO370 area, and the 
CP-resident nucleus. Therefore, if your other storage areas remain constant, your 
dynamic paging area should be sufficient. 


Installing CMS 
If you want to support CMS as a named saved system in both System/370 and 
370-XA mode, you must create two CMS named saved systems: one for System/370 
mode and one for 370-XA mode. 


The VM/XA SP CMS requires 2Mb of virtual storage when installed as an NSS. 


Differences Loading (IPLing) the New System 


Saving Spool Files 
Changes to the spool file system require you to do a cold start when you bring up 
VM/XA SP for the very first time. You must process VM/XA SF spool files or save 
them using the SPTAPE command. 


The User Directory 
VM/XA SP allows you to place a user directory on any CP-owned DASD volume. 
A CP-owned volume is any disk that is designated as owned by the system; for 
example, the CP system-residence volume (SYSRES), or any disk that contains CP 
paging, spooling, temporary, or directory disk space. You create a list of CP-owned 
volumes on the SYSCPVOL macro instruction in the system control file (HCPSYS 
ASSEMBLE) at system generation time. 


When CP initializes, it looks for a user directory on the system-residence volume 
first. If no user directory is there, CP follows the order of the list of CP-owned 
volumes on the SYSCPVOL macro instruction in its search for a user directory. CP 
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selects the first directory it finds. If CP finds no user directory, or if CP finds an 
invalid user directory, CP logs on an operator to allow you to create a valid user 
directory. 


For more information about user directory changes, see “Differences Managing User 
Access” on page 18]. 


Differences Applying Service to the System 


The preventive service process has changed since VM/XA SF. 


The program update tape (PUT) no longer includes AUX files for VM/XA SP 
service. There are new files on the PUT that the service process uses. These files 
include patch update files, update shells, text shells, a product parameter file, a PTF 
parts list, an apply list, and an exclude list. 


You cannot use VMSERV for VM/XA SP, although the EXEC has been retained 
for compatibility. New EXECs (actually delivered on the VM/XA SP product tape) 
replace VMSERV functions and the product service EXEC. You can use VMSERV 
for other products, but for VM/XA SP you must use the VMFREC EXEC instead. 


The new EXECs are VMFREC, VMFAPPLY, and VMFBLD. These EXECs 
require information supplied by a CMS file called the product parameter file. This 
file contains the following: 


¢ Control information, such as the name of the main and auxiliary control files to 
be used and the verification functions to be performed while service is applied. 
The name of the user exit EXEC that is called at the beginning and end of each 
service function is also supplied in this section. 


e The minidisks to be used for (1) holding source and object code, IBM-supplied 
service files, and user-supplied service files, (2) performing updates, and (3) 
regenerating the nucleus. | 


e The EXECs needed to update each part of the component. 


The VMFREC EXEC receives service from the PUT and creates a service process 
data base. The VMFREC INFO command maps the PUT and receives the PUT 
documentation. The VMFREC 5664308 CP or VMFREC 5664308 CMS command 
loads the service files onto the minidisks specified in the product parameter file. Any 
errors that arise from the VMFREC EXEC are logged in a receive exception log on 
the installer’s A-disk. VWMFREC also creates a receive history log, which contains a 
list of all CMS files received from the PUT. 


The VMFAPPLY EXEC builds the auxiliary control files that are used to apply 
updates to source and object code. The auxiliary control files are built in 
accordance with the apply list and, optionally, the exclude list for the component. 
The apply list is a list of the program temporary fixes (PTFs) that are to be applied 
to the component. The exclude list is a list of the PTFs that are not to be applied to 
the component, even though they are listed in the apply list. 


When invoking the VMFAPPLY EXEC, the installer specifies the number of the 
product (5664308 for VM/XA SP), the name of the component, and the filetype of 
the auxiliary control files that are to be built. Options can be specified that control 
whether or not the exclude list is used, errors are logged, and checking is performed. 
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The VMFAPPLY EXEC creates or edits the necessary auxiliary control files and, if 
appropriate, invokes the VMFAPNLS EXEC to create auxiliary control files for 
national language support. The new auxiliary control files are used for source code 
files when the source code files are assembled via the VMFHASM EXEC. 


After service has been received and applied, and source code files have been 
re-assembled, the VMFBLD EXEC is used to generate a new nucleus for the 
specified component. Corequisite and prerequisite checking is done automatically 
based on information in the AUX files. 


The method used to apply service depends on whether the code to be serviced has 
been supplied as source code or object code. These methods are used automatically 
by the EXECs already discussed. | 


The changes to the preventive service procedures are significant, so you should read 
VM/XA SP Installation and Service to get acquainted with them. 


Message Compatibility 
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See “VM/XA SF and VM/XA SP Message Compatibility” on page 218. 


New Functions That Do Not Affect Conversion 


The following new functions in VM/XA SP do not directly affect your conversion 
unless you decide to use them. To exploit these functions, be sure to read the other 
publications in the VM/XA SP library. The new functions include: 


¢ The SYSFCN macro, which defines the privilege classes for certain CP internal 
functions 


¢ The MODEL parameter on the RDEVICE macro for 3270 displays, which is 
now optional 


e New device support 
e The PARMREGS option on the DEFSYS command 


e¢ The group control system (GCS), a component that allows you to implement a 
native SNA communication network or run RSCS Version 2 


e An enhancement to the DIRECTXA command and the directory build process 
that provides automatic deactivation of restricted passwords (ADRP). 
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Chapter 14. Administration 


Administration tasks include managing user access to the system, managing system 
resources, and managing system performance. 


Some CP externals used in administration differ between VM/XA SP and VM/XA 
SF. 


Differences Managing User Access 


Changes to the DIRECTXA Command 
The syntax of the DIRECTXA command is unchanged. However, the command 
now brings the directory online if and only if one of the following is true: 


( * 1. The new directory is on the same volume as the directory CP found at 
! initialization time. In VM/XA SF this volume had to be the system residence 
volume. 


2. DIRECTXA has not yet found a directory and the new directory is on a 
CP-owned volume. 


The privilege class D QUERY ALLOC command responds with “ACTIVE” for the 
volume on which the currently active directory resides. 


a For more information about the user directory and CP initialization, see 
( “Differences Loading (IPLing) the New System” on page 178 and “Differences 
Bringing Up the System” on page 187. 
Setting the Spool File Limit for Users 
The SPOOLFILE user directory control statement is optional, but if you do not 
code one for a user the maximum number of spool files for that user 1s 9999. 


| Issuing Diagnostic CCW Commands 
| In VM/XA SP, Diagnostic CCW commands require class F authority. 


Differences Managing System Data Files 


Saving and Purging Saved Segments 
Only one available (class A or R) saved segment with a particular name may exist at 
a given time. If any class A or R saved segment already exists with the same name 
as the one being saved, and there are no virtual machine users associated with the 
saved segment, then the old copy of the saved segment is purged and the new one is 
made available. 


| Note that the SPTAPE LOAD command can load an additional version of a system 
| data file with the same name and class as one already in existence. This can cause 

| unexpected results because CP uses whichever one it encounters first. In such a 

| situation you should purge one of the system data files. 


If there are users associated with the old copy of a saved segment and the saved 
segment is a CP DCSS, the SAVESEG command is not accepted. A CP DCSS is a 
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CP system service DCSS and its page ranges are defined with the SC page descriptor 
code. | | | 


If there are users associated with the old copy and the saved segment is not a CP 
DCSS, the old copy is marked as pending purge, and the new copy is saved. 


If you try to purge a saved segment with the PURGE NSS command while users are 
still associated with it, the saved segment is marked as class P, pending purge. For 
such a saved segment: | 


¢ You cannot save a new copy of a CP DCSS. 


e You can save a new copy of a non-CP DCSS. 


Displaying Information about System Data Files 


The QUERY NSS MAP command responds with new information about: - 


e The range of registers in which parameters are passed to the virtual machine 
during the IPL (via PARMREGS) 7 


e For NSS files only, whether the VMGROUFP attribute was specified on the 
DEFSYS command when the named saved system was created (VMGROUP). 


The QUERY NSS MAP command also responds with new types for the system 
data file: 


e CPNSS, to indicate a CP system service NSS 

e CPDCSS, to indicate a CP system service DCSS 

¢ DCSS-M, to indicate a member of a segment space 

¢ DCSS-S, to indicate a segment space for which members were defined. 


The QUERY NSS command responds with the OWNERID as *NSS and displays 
the originator (ORIGINID) of the file. 


The QUERY IMG command responds with the OWNERID as *IMG and displays 
the originator (ORIGINID) of the file. 


The privilege class A, B, and C QUERY SDF command responds with the number 
of user class restructure (UCR) files. The privilege class A, C, D, E, and G QUERY 
SDF command responds with the number of system trace (TRF) files. 


Differences Managing Resource Usage 


Finding the Size of Main Storage 


The privilege class B command, QUERY STORAGE, now has a response like that 
in VM/SP HPO: 


STORAGE = nnnnM 


Or 


STORAGE = nnnnnnnk 


The size of main storage is calculated as the minimum of system-generated storage 
and configured main storage. 
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The new QUERY FRAMES command returns information peer displayed by 
the eee. SF QUERY STORAGE command. 


Differences Managing System Performance 


Displaying the Contention for Storage and Processor Use 
The INDICATE LOAD command gives some additional data and the output of all 
data is reformatted. For the privilege class E user, INDICATE LOAD displays the 
eligible list classes (E1, E2, and E3) and users in the dispatch list (Q0, QI, Q2, and 
Q3). The command displays system-wide information in its own block. Information 
relating to individual processors and their vector processors are in sets of two per 
line. The command now includes EXPAN and STEAL information to be 
compatible with VM/SP HPO. PROC replaces CPU for VM/SP HPO compatibility. 


Displaying Active Users 
INDICATE QUEUES gives information about whether the virtual machine is 
virtual MP, the processor number, the virtual machine’s eligible list class, and 
dispatch list class. 


Controlling the System Scheduler 
You can no longer query or set shares for a user on the QUERY SRM command or 
SET SRM command. Use the QUERY SHARE or SET SHARE commands 
instead. Note also that ABSCPU is not a valid option for shares on the system. 


For general information on the scheduler, see “General Changes to the Scheduler” 
on page 154. 


Start Interpretive-Execution Assist Consideration 


For System/370 preferred virtual machines, the start interpretive-execution assist is 
available only for I/O devices that have virtual addresses less than or equal to hex 
FFF. 


Changed User Exit 


You can add your own accounting routine to the system through the IBM-supplied 
module, HCPACU. The routine can perform additional functions when a virtual 
machine logs on or off, when an authorized user issues accounting commands, or 
when system initialization or termination invokes a CP checkpoint routine. 


Message Compatibility 
See “VM/XA SF and VM/XA SP Message Compatibility” on page 218. 
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New Functions That Do Not Affect Conversion 


The following new functions in VM/XA SP do not directly affect your conversion 
unless you decide to use them. To exploit these functions, be sure to read the other 
publications in the VM/XA SP library. 


e New CP system services on the IUCV user directory control statement: 


—- *BLOCKIO 
“= “CCS 
—- *MONITOR 
= RPI 
— *SIGNAL. 
e New externals for the protected application environment: 
— The PARM option on the IPL user directory control statement and ec > 
command 7 SN 
— The CONCEAL option on the OPTION user directory control statement. 
e New externals for changing privilege classes: 
— Use of the CMS class override file 
— The OVERRIDE command 
— The CLASS user directory control statement 
— Coding an asterisk in place of the privilege class on the USER user directory - 7 
control statement when coding new classes So 
~ The new DIAGNOSE code X'C4' 
— The new PURGE UCR command, which allows you to purge user class 
restructure (UCR) files . . 
— The new QUERY UCR command, which allows you to display detailed 
information about one or more user class restructure (UCR) files. 
e The new QUERY FRAMES command. f~™ 
e The new externals for the scheduler: oe 


— The QUICKDSP option on the OPTION user directory control statement 
— The QUERY QUICKDSP and SET QUICKDSP commands 
— The QUERY SHARE and SET SHARE commands. 


— The QUERY SRM ALL command, which responds with a summary of the 
current system-wide scheduler settings 


— The QUERY/SET SRM LDUBUF commands, which refer to the 
commitment of system paging 


— The QUERY/SET SRM STORBUF commands, which refer to the 
scheduler’s policy in allocating storage 


— The QUERY/SET SRM DSPBUF commands, which refer to the scheduler’s 
policy for limiting the number of users allowed in the dispatch list for each 
transaction class. | 
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The new programming interfaces for the RACF licensed program: 


The ACIGROUP user directory control statement, which allows you to 
identify users and resources as members of a group to the RACF licensed 
program 


DIAGNOSE X'A0O', which retrieves the access control group name and 
determines whether ACI program is installed. 


New externals for the VM/XA SP monitor: 


The MONITOR command and the monitor writer sample program which 
lets you control the selection, collection, and reporting of data from the 
system 


The QUERY MONITOR command, which lets you display the current 
profile information for the system monitor 


The use of the page descriptor code of SC on the DEFSEG and DEFSYS 
commands, which establishes CP writable pages that are shared by a virtual 
machine in read-only access 


A new option on the OPTION user directory control statement, SVMSTAT, 
that allows you to distinguish between statistics taken for service virtual 
machines and end user virtual machines 


The SET MONDATA command, which allows you to determine whether 
the monitor places input and output from user displays in terminal event 
records 


The QUERY MONDATA command, which allows you to find out whether 
the monitor is placing input and output from user displays in terminal event 
records. 


New externals for multiple preferred guest support: 


DEDICATE/NODEDICATE options on the OPTION user directory 
control statement, which specify whether a real processor is dedicated to a 
V=R or V=F machine at logon 


DEDICATE/NODEDICATE options on the CPU user directory control 
statement, which specify whether a real processor is dedicated to a virtual 
machine at logon 


A new parameter (MDC/NOMDC) on the MINIOPT directory control 
statement that specifies whether a minidisk is to use Expanded Storage cache 


The group control system (GCS), a component that allows you to implement a 
native SNA communication network or run RSCS Version 2. 
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Chapter 15. Real System Operation 


Real system operation tasks include starting and stopping the system, controlling 
processors, controlling I/O, managing data files, and running utility programs. 


For conversion from VM/XA SF, some CP commands are changed due to VM/XA 
SP’s increased compatibility with VM/SP HPO. 


Differences Bringing Up the System 


Saving Spool Files 
Changes to the spool file system require you to perform a cold start when bringing 
up VM/XA SP for the very first time. You must process VM/XA SF spool files or 
( | save them using the SPTAPE command. 


The User Directory 
When CP initializes, it looks for a user directory on the system-residence volume 
first. If no user directory is there, CP follows the order of the list of CP-owned 
volumes on the SYSCPVOL macro instruction in its search for a user directory. CP 
selects the first directory it finds. If CP finds no user directory, or if CP finds an 
invalid user directory, CP logs on an operator to allow you to create a valid user 
directory. 


port, The privilege class D QUERY ALLOC command now responds with ACTIVE for 
( | the volume on which the currently active directory resides. 


Setting up the System Abend Dump Environment 
The privilege class B SET DUMP command now has a V=R option that allows you 
to specify that the entire V=R area and CP storage should be dumped in the event 
of a system abend. The response to the SET DUMP command includes the V=R 
‘setting, if set. 


The QUERY DUMP command response includes the V=R setting, if it 1s set. 


Differences Controlling I/O 


Controlling the Missing Interrupt Handler 
The SET MITIME command allows you to specify multiple device classes with a 
single command invocation. The GRAF operand on SET MITIME replaces 
DISPLAY. DISPLAY is not accepted. 


QUERY MITIME uses GRAF rather than DISPLAY in its response. 
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Differences Controlling Printers | 


Finding out a Printer’s Status 


Starting Printers 


The response to the QUERY UR command for impact printers adds a third line 
which includes the image library, character set, and forms control buffer (FCB) 
being used, with the exception of the 1403 printer models that do not have the 
universal character set feature installed. For HOSS printers, VM/XA SP does not 
display the third line of the response. 


The START command allows the specification of an image library, FCB, and 
character set for impact printers. The operator may now specify the FCB and 


character set to be loaded and start impact printers with a START command alone, 


rather than with three commands (LOADBUF FCB, LOADBUF UCS, and 
START). The operator now has the same command set to operate all spooling 
printers. | 


Note: The CHARS option is not valid for 1403 printers without the universal 
character set (UCS) feature, 4245 printers, and 4248 printers. 


For impact printers only, START accepts a new FOLD/NOFOLD option, which 
controls whether lowercase characters are translated (folded) into uppercase 
characters for output. This option corresponds to the aca nee option on 
the LOADBUF command. 


For the sake of compatibility with existing impact printer terminology, UNFOLD is 


accepted as the equivalent of NOF OLD. 


For 3211 printers only, the START command accepts a new INDEX option, 
corresponding to the existing INDEX option on the LOADBUF command. 


The response to the START command for impact printers adds a third line which 


includes the image library, character set, and forms control buffer (FCB) being used, 


with the exception of the 1403 printer models that do not have the universal 
character set feature installed. For those printers, VM/XA SP does not display the 
third line of the response. 


Setting Character Sets and Spacing for Impact Printers 


The LOADBUF command is obsolete since the START command allows an 
operator to specify the FCB and character set and to start an impact printer with 
one command. The LOADBUF command is maintained for the sake of 
compatibility. 


Draining Impact Printers 


The response to the DRAIN command for impact printers adds a third line which 


includes the image library, character set, and forms control buffer (FCB) being used, 


with the exception of the 1403 printer models that do not have the universal 
character set feature installed. For those printers, VM/XA SP does not display the 
third line of the response. 
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Differences Controlling Displays 


Clearing Pending Interrupts for a Display 
The RESET command responds with the keyword GRAF rather than DISPLAY: 


GRAF vdev RESET 
Querying Displays 


The privilege class BQUERY command accepts only GRAF for real display 
devices. DISPLAY is no longer accepted. 


Attaching Displays 
The privilege class B ATTACH command responds with the keyword GRAF rather 
than DISPLAY. 


Differences Controlling DASD 


Finding out about User Access to a System-Owned DASD 
The privilege class BQUERY SYSTEM command now has the response: 


userid vdev mode 


where: 

userid identifies the user who has a link to a minidisk on the system-owned 
DASD. 

vdey is the virtual address by which the user refers to the minidisk. 

mode Is the type of access the user has: either R/O, R/W, or nnn for the 


number of cylinders of temporary disk space allocated. 


Displaying Currently-Defined Temporary Disk Space 
The privilege class BQUERY SYSTEM TDSK command: 


¢ No longer provides what used to be the first line of the VM/XA SF response 


e Uses a number (mmnn) for a TDISK cylinder count instead of Tnnnn as in 
VM/XA SF. 


Differences Controlling Spooled Output 


Changing the External Attributes of Spool Files 
Changes to the spool file limit function make a spool ID unique by user. Thus, the 


privilege class D CHANGE command no longer allows the spoolid option with the 
SYSTEM keyword. : 


Responses to the CHANGE command with the TO option include the new spool ID 
given to the file after it is changed. 


The response that indicates the number of files changed by the CHANGE command 
now allows a number up to seven digits. 
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Changing the Order of Spool Files on a Queue | 
Changes to the spool file limit function make a spool ID unique by user. Thus, the 


privilege class D ORDER command no longer allows the spoolid option with the 
SYSTEM keyword. 


The response that indicates the number of files ordered by the ORDER command 
now allows a number up to seven digits. 


Purging Spool Files 

_— Changes to the spool file limit function make a spool ID unique by user. Thus, the 
privilege class D PURGE command no longer allows the spoolid option with the 
SYSTEM keyword. The response that indicates the number of files purged by the 
PURGE command now allows a number up to seven digits. 


Finding Out the Count of Reader, Printer, and Punch Spool Files 
Changes to the spool file limit function make a spool ID unique by user. Thus, the 
privilege class D QUERY FILES command no longer allows the spoolid option with 
the SYSTEM keyword. 


The response to the privilege class D QUERY FILES command allows a number up 
to seven digits. _ 


Finding out Detailed Information about a Spool File 
Changes to the spool file limit function make a spool ID unique by user. Thus, the 
privilege class D QUERY RDR/PRT/PUN command no longer allows the spoolid 
option with the SYSTEM keyword. 


Sending and Retrieving Spool Files to and from Another User | 
Changes to the spool file limit function make a spool ID unique by user. Thus, the 
privilege class D TRANSFER command no longer allows the spoolid option with the 
SYSTEM keyword. 


Responses to the TRANSFER command with the TO option include the new spool 
ID given to the file after it is changed. 


Differences Communicating with Users and CP 


Creating and Changing the System Log Message 
NULL 1s no longer the default for SET LOGMSG nn. Instead, you are put in the 
CP READ state to allow you to enter a line of text or NULL. 


Logging On Another Virtual Machine 
— The VM/XA SF AUTOLOG command is changed to XAUTOLOG in VM/XA. SP. 
XAUTOLOG has additional operands. 


VM/XA SF issues message 050E when you specify an incorrect password. VM/XA 
SP issues message 050E when you specify an incorrect password and XAUTOLOG 
executes asynchronously, but issues message 6054E when you specify an incorrect 
password and XAUTOLOG executes synchronously. (XAUTOLOG executes 
synchronously when you specify the SYNCH option.) : | 


The primary system operator can no longer log on a user unless the operator has 
privilege class A or B. 
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| For compatibility with VM/SP HPO, AUTOLOG still exists in VM/XA SP; 
| however, it has less function than XAUTOLOG. 


Finding Out Which Users Are in Logon Hold Status 
You must use the class BQUERY HOLD LOG command to find out which users 
have logon hold in effect. | 


Differences Shutting Down the System 


A privilege class A user other than the primary system operator can issue 
SHUTDOWN. In such a case, the response SYSTEM SHUTDOWN STARTED 
goes to both the invoker and the primary system operator. 


Message Compatibility 
( | See “VM/XA SF and VM/XA SP Message Compatibility” on page 218. 


New Functions That Do Not Affect Conversion 


The following new functions in VM/XA SP do not directly affect your conversion 
unless you decide to use them. To exploit these functions, be sure to read the other 
publications in the VM/XA SP library. 


e The SPTAPE command, which now supports saving and restoring user class 
restructure (UCR) files 


( ; ¢ The PURGE UR command, which allows you to purge all spool files associated 
ad with a unit record device that match the selection criteria specified (ALL, 
CLASS, FORM, spool ID) 


e The privilege class D QUERY MAXSPOOL command, which allows you to 
display the spool file limit for the system or for any individual user 


¢ The QUERY XSTORE MAP command, which displays a map showing how 
Expanded Storage is currently allocated 


disks 


¢ The QUERY/SET MAXUSERS commands, which allow you to control the 
number of users who can log on the system 


( - ¢ The QUERY TDSK command, which displays information about temporary 


| ¢ The QUERY TRF command, which displays the names of system trace files that 
| are available 


| ° The SPTAPE DUMP rdev TRF ALL command, which dumps system trace files 
| to a tape 


| ¢ The SPTAPE LOAD rdevy TRF ALL command, which loads system trace files 
| from a tape 


| _ © The COMPACT option of the OUTPUT statement of the DDRXA program, 
| which compresses output when writing to a tape 


The MDC operand of the RETAIN XSTORE command, which specifies 
| whether parameters controlling the use of Expanded Storage as a cache for CMS 
| minidisks are being changed 
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| e The group control system (GCS), a component that allows you to implement a 
| native SNA communication network or run RSCS Version 2. 
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Chapter 16. Virtual Machine Operation 


Virtual machine operation tasks include those tasks that allow you to run operating 
systems in virtual machines. 


For conversion from VM/XA SF, increased compatibility with VM/SP HPO causes 
some differences in CP externals such as commands and command responses. 


Differences Controlling Virtual Devices 


Detaching Virtual Devices 


The DETACH command’s response for a multiple exposure device is now 
compatible with VM/SP HPO: 


vdev pagedevl pagedev2 pagedev3 DETACHED 


where: 

vdev is the base virtual device number of the multiple-exposure device. 
pagedevl 

pagedev2 

pagedev3 are the virtual paging device numbers of the multiple-exposure device. 


Note the keyword DASD does not appear in the response. 


Differences Controlling Printers 


Setting Spacing for a Virtual Printer 
The LOADVFCB command includes an optional IMAGE specification and supports 
the 3262, 4245, and 4248 printers. If you do not specify the IMAGE option, the 
command uses the default image library for the device type. The default image 
library is IMAGxxxx, where xxxx is the device type. For example, the 1403 has a 
default image library called IMAG1403. 


Differences Controlling Reader, Printer, and Punch Files 


Changing the External Attributes of Spool Files 
| Responses to the privilege class G CHANGE command with the TO option include 
the new spool ID given to the file after it 1s changed. 


The response that indicates the number of files changed by the CHANGE command 
now allows a number up to seven digits. 
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Changing the Order of Spool Files on a Queue 
The response that indicates the number of files ordered by the privilege class G 
ORDER command now allows a number up to seven digits. 


Purging Spool Files 
The response that indicates the number of files purged by the privilege class G 
PURGE command now allows a number up to seven digits. | | 


Sending and Retrieving Spool Files to and from a User 
The response that indicates the number of files changed by the privilege class G 
TRANSFER command now allows a number up to seven digits. 


Querying Spool Files 
The response to the QUERY RDR/PRT/PUN command has changed. Use 
QUERY RDR/PRT/PUN ALL instead. 


Differences Controlling Tapes - 


Rewinding Tapes | 
The privilege class G REWIND command has two new responses. When the rewind 
operation is pending, you receive: 


REWIND NOT PERFORMED 


When the rewind operation is started, you receive: 
REWIND COMPLETE la 


Differences Controlling Your Display 


Clearing Pending Interrupts for a Display 
The RESET command responds with the keyword GRAF rather than DISPLAY. 


GRAF vdev RESET 


where: | 


vdev is the virtual device number of the display. 


Defining Displays | | 
The privilege class G DEFINE command accepts only GRAF for displays. 
DISPLAY is no longer accepted. 


Detaching Displays 
The privilege class G DETACH VIRTUAL DEVICE command uses GRAF rather 
than DISPLAY in its response when the device detached is a display. 


Logically Connecting Your Display to Another Operating System in a Virtual Machine 
The privilege class ANY DIAL command responses now omit type rdev from their 
beginning. For example, the response you get when the logical connection is made 
1S: | 


DIALED T0 userid vdev 
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where: 

userid is the user identification of the virtual machine that is running the 
operating system. 

vdev is the virtual device number of the dialed connection. 


Displaying the Status of Your Virtual Displays 
The privilege class G QUERY VIRTUAL command accepts only GRAF. It no 
longer accepts DISPLAY. The response also uses the keywork GRAF. 


Displaying the Status of Your Virtual Console 
The privilege class G QUERY VIRTUAL CONSOLE provides information 
compatible with VM/SP HPO. It does not display such data as EOF, OPEN, and 
KEEP. 


Controlling the Settings for Your Virtual Console Environment 
The privilege class G TERMINAL command no longer supports the LINEDIT, 
MSG, WNG, EMSG, and IMSG options. 


Displaying the Current Settings for Your Virtual Console Environment 
The privilege class G QUERY TERMINAL response now displays BRKKEY PFO1, 
..., PFO9 rather than BRKKEY PF1, ..., PF9. 


Differences Communicating with Users and CP 


Displaying a List of Logged-On Users 
The response to QUERY NAMES now displays: 


e A disconnected user as DSC rather than DISC 
e The invoking user ID as the last in the list rather than the first. 


Stopping Your Virtual Machine for a Specified Period of Time 
The SLEEP command no longer automatically issues a nonzero return code if the 
sleep period is prematurely ended by the attention key. Rather, you must issue a 
new option on the SLEEP command, ATTN. This option indicates that if the 
SLEEP command with a time interval was issued, the return code should indicate 
whether the SLEEP command ended because the time interval expired (RC = 0) or 
because an attention was signaled (RC = 1457). 


Displaying the Number of Logged-On Users 
The QUERY USERS command now displays a disconnected user as DSC rather 
than DISC. 


Displaying the Status of a User ID 
The response to QUERY userid now displays a disconnected user as DSC rather 
than DISC. 


Displaying the Settings of Your PF Keys | 
The privilege class G QUERY PF command no longer displays saved lines under the 
line indicating the PF key that is set to RETRIEVE. You no longer receive the 
response ALL PFS UNDEFINED when there are no PF keys defined. Rather, you 
receive PFnn UNDEFINED for each key. 
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Setting Your Account Number 
SET ACNT continues to be unsupported as it was in VM/XA SF. However, 
VM/XA SP responds with an error message informing you the command option is 
not supported. As in VM/XA SF, substitute SET ACCOUNT. 


Differences Determining System Response 


Determining System Storage and Processor Use : 
The privilege class G INDICATE LOAD command gives additional data and the 
output of all data is reformatted. 


Differences Controlling Virtual Machine Storage and Registers 


pforing Data in Virtual Machine Storage es 
The default for the STORE GUEST STORAGE command is now guest real storage ee 
rather than guest logical storage. 


Displaying and Dumping Virtual Machine Storage 
The DISPLAY STORAGE and DUMP STORAGE commands now have guest real 
storage as the default. 


DISPLAY STORAGE and DUMP STORAGE allow default values for the starting 
or ending storage addresses. 


Xe. 


DISPLAY STORAGE and DUMP STORAGE now round the starting address for 
all translated output to a hex 10 boundary. If you do not specify a length, the hex 
10 bytes are displayed or dumped. 


Displaying and Dumping Registers 
The responses to the DISPLAY REGISTERS and DUMP REGISTERS commands 
use GPR n rather than Gn for general registers, CR n rather than Xn for control 
registers, and FPR n instead of Yn for floating point registers. 


Differences Running Guest Operating Systems 


Loading (IPLing) an Operating System 
The privilege class G IPL command has changes for the PARM option. The string 
you insert into the virtual machine’s registers is delimited by a byte of binary zeros. 
If you load (IPL) a named saved system, the command fills your virtual machine 
registers with the parameter string in the order specified on the PARMREGS option 
on the DEFSYS command. 


Loading (IPLing) CMS 
Changes to CMS may change virtual machine operations. For instance, a user must 
load one CMS named saved system for System/370 mode and another for 370-XA 
mode. 
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Setting the Virtual Console Mode 
pos A virtual machine reset no longer resets the terminal console mode established by the 
( 7 TERMINAL CONMODE command. In VM/XA SF, a typical strategy was to 

define an MVS user ID with terminal console mode set to 3270 in the user directory. 
This virtual machine could load (IPL) CMS at logon because CMS automatically 
sets its console to 3215, the console mode it requires. CMS was used to manage the 
virtual machine prior to loading MVS. When MVS was loaded (IPL), the resulting 
virtual machine reset also reset the terminal console mode to the value in the 
directory (3270). Thus, the 3270 console setting required by MVS was automatically 
established. 


Since VM/XA SP no longer resets the terminal console mode to 3270 when the 
virtual machine is reset, loading MVS after CMS results in a disabled wait state 
1010. To avoid this, enter TERMINAL CONSOLE 3270 prior to loading (IPL) 
MVS. 


( Differences Managing the Virtual Processing Environment 


Finding Out Settings for Your Virtual Machine 
The QUERY SET command responds with an indication of whether the protected 
application environment is active or not. 


Differences Tracing Programs 


Using the TRACE Command 
The response to QUERY TRACE includes information about the TRACE COUNT, 
when active, and the DATA option of instruction traps. 


The TRACE command has added functions: 


¢ The DATA option on the TRACE INSTR command, which specifies a string of 
data to compare to the instruction data 


( . ¢ The TRACE COUNT command, which counts trace events 


¢ The traceback table function, which keeps track of the last six successful branch 
instructions, and the TRACE TABLE command to display the traceback table 


¢ The TRACE APPEND command, which combines trace traps from two sets 
into one set 


¢ The RANGE keyword, which is a synonym for FROM when specifying address 
ranges 


¢ The BOTH option, which is a synonym for PRINTER oe TERMINAL when 
specifying the destination of trace output. 


Message Compatibility 
See “VM/XA SF and VM/XA SP Message Compatibility” on page 218. 
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New Functions That Do Not Affect Conversion 


The following new functions in VM/XA SP do not directly affect your conversion 
unless you decide to use them. To exploit these functions, be sure to read the other 
publications in the VM/XA SP library. These functions are: 


e The STORE STATUS Pominand: an alias for SYSTEM STORE STATUS 
¢ The QUERY PER command, an alias for QUERY TRACE 
e The PER command, an alias for TRACE 


e The QUERY VIRTUAL PRINTER and QUERY VIRTUAL UR command 
responses, which display information about new device types 3262, 4245, and 
4248 | | 


e The DEFINE command, which now allows you to: 
— Define 3262, 4245, and 4248 devices. 


— Issue VM/SP HPO operands. Those operands not supported by VM/XA SP a 
result in an error message. 


— Define a 3800 printer with the DEFINE PRINTER command. 
e New and changed externals for the protected application environment: 


— The DEFINE CPU command, which cancels the protected application 
environment if you use the command to establish a virtual MP environment 


— The SET CONCEAL command, which activates or deactivates the protected 
application environment fo 


— The LOGON command with the NORUN option, which allows a user Sor 
running in the protected application environment to disconnect and to log 
back on the system to issue CP commands otherwise not allowed by the 
protected application environment _ 


— The QUERY TERMINAL command, which now displays NONE for the 
BRKKEY setting when disabled by the protected application environment 


— The TERMINAL BRKKEY command, which reenables the BRKKEY 
while in the protected application environment. oo 


¢ The COMMANDS and QUERY COMMANDS commands, which allow you to su 
display commands and DIAGNOSE codes you can issue. 


e The SPOOL command, which now has a SYSTEM option on the TO or FOR 
keywords that resets the attributes of the device to its defaults as set in your user 
directory entry | | 


¢ The PURGE UR command, which allows you to purge all spool files associated 
with a unit record device that match the selection criteria specified (ALL, 
CLASS, FORM, spool ID) 


e The privilege class G QUERY MAXSPOOL command, which allows you to 
display your spool file limit 


¢ The DETACH command, which now accepts VM/SP HPO operands, though 
they are not supported by VM/XA SP 


e New controls for your display: 


—- The TERMINAL ASCIITBL command, which allows you to select the 
translation table that is used by your TTY terminal 
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— The TERMINAL ATTN command, which allows you to control the 
signaling of an attention interruption on your ASCII terminal 


—- The TERMINAL CNTL command, which allows either CP or an 
application program to insert TTY line control characters for your TTY 
terminal 


—- The TERMINAL HILIGHT command, which allows you to highlight the 
command redisplay line 


— The TERMINAL PROMPT command, which sets the prompting sequence 
to be used on a TTY device 


— The TERMINAL SCROLL command, which allows you to specify the 
number of scrolled lines on a 3101 display screen 


— The TERMINAL TABCHAR command, which allows you to set logical tab 
characters on display devices 


— The TERMINAL TYPE command, which allows you to define a device as a 
3101 or asa TTY terminal 


— The QUERY TERMINAL command, which displays new settings for 
TABCHAR and HILIGHT, if you set them 


— The SCREEN command, which allows you to set or change the extended 
color and extended highlighting values 


— The QUERY SCREEN command, which allows you to display the extended 
color and extended highlighting values. 


The BEGIN command, which now allows a minimum abbreviation of B for all 
command options. In VM/XA SF this command allowed a minimum of B only 
for the * option 


The SET PFnn SUBSTITU command, which substitutes any “&n” (for example, 
&1) in the PF data with a token from the input area when the PF key is pressed 


The SET PFun NODISP command, which specifies that the program function is 
executed when the PF key is pressed 


The SET PFun RETRIEVE CLEAR command, which clears the RETRIEVE 
buffer if already in use 


The CMS SET AUTODUMP command, which allows you to control the 
creation of a dump of the CMS nucleus (DMSNUC) in the event of an 
abnormal termination. 
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Chapter 17. Application End Use 


Application end use tasks include logging on to the system, running applications, 
and responding to system messages. 


Minor differences exist between VM/XA SF and VM/XA SP CP externals. Some 
CP commands have error message differences. For instance, the DIAL command 
responds with the VM/SP HPO response format. 


Differences Connecting Your Display to Another System 


Logically Connecting Your Display to Another Operating System in a Virtual Machine 
The privilege class ANY DIAL command responses now omit type rdev from their 
( * responses. For example, the response you get when the logical connection is made 
1S: 
DIALED TO userid vdev 


where: 

userid is the user identification of the virtual machine that is running the 
operating system. 

vdev is the virtual device number of the dialed connection. 


Differences Communicating with Users and CP 


Displaying a List of Logged-On Users 
The response to QUERY NAMES now displays: 


e A disconnected user as DSC rather than DISC 
e The invoking user ID as the last in the list rather than the first. 


( Displaying the Number of Logged-On Users 
” The QUERY USERS command now displays a disconnected user as DSC rather 
than DISC. 


Displaying the Status of a User ID 


The response to QUERY userid now displays a disconnected user as DSC rather 
than DISC. 


Displaying the Settings of Your PF Keys 
The privilege class G QUERY PF command no longer displays saved lines under a 
PF key that is set to RETRIEVE. 


oO 
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Message Compatibility ; SO 7 
See “VM/XA SF and VM/XA SP Message Compatibility” on page 218. 


New Functions That Do Not Affect Conversion 


The following new functions in VM/XA SP do not directly affect your conversion 
unless you decide to use them. To exploit these functions, be sure to read the other 
publications in the VM/XA SP library. 


¢ The COMMANDS and QUERY COMMANDS commands, which allow you to 
display commands and DIAGNOSE codes you can issue 


¢ The BEGIN command, which now allows a minimum abbreviation of B for all 
command options. In VM/XA SF this command allowed a minimum of B only 


for the * option. 
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Chapter 18. Application Programming 


Application programming tasks include program development and program 
debugging. 


Architecture Differences 


The CMS component of VM/XA SP has an interface to both System/370 
architecture and 370-XA architecture. When CMS runs in a System/370 virtual 
machine, it provides an interface to System/370 architecture. When CMS runs in a 
370-XA virtual machine, it provides an interface to 370-XA architecture. 


The major architectural differences are: 


e Program status words for each architecture are different. 

e Addressing increases from 24 bits for System/370 to 31 bits for 370-XA. 

e I/O handling for each architecture has unique instructions and routing abilities. 
e There are new and changed assembler language instructions for 370-XA. 


For more information, see VM/XA SP CMS Application Program Development 
Guide. 


Summary of Compatibility 


The CMS component of VM/XA SP is generally compatible with the CMS 
component in VM/SP Release 5. Since VM/XA SF Release 2 supports a CMS 
component that is equivalent to the CMS component in VM/SP Release 4, you must 
evaluate changes to CMS between VM/SP Release 4 and Release 5. Refer to 
VM/SP Release 5 publications to make this evaluation. With the exceptions noted 
below, all VM/XA SP CMS commands are compatible with VM/SP Release 5. 
There are new CMS commands that invoke new function and there are enhanced 
commands to invoke enhanced function. The enhanced commands are upwardly 
compatible with the VM/SP Release 5 CMS. CMS macros in VM/XA SP are 
upwardly compatible, and CMS external control blocks are compatible with the 
VM/SP Release 5 CMS. 


In general, if your application program uses standard CMS interfaces (for example, 
if it does not manipulate PSWs or depend on CMS internal control blocks) and does 
not depend on CP command and DIAGNOSE code invocations or responses, you 
should not need to recompile or reassemble the program before running it on CMS 
in System/370 mode. For higher-level languages that VM/XA SP supports, 
programs are source and object code compatible. 
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Conversion Stages 


While the conversion effort varies from installation to installation, there are three 
basic stages, or levels, of conversion to VM/XA SP CMS: 


Virtual 


Machine Addressing 
Stage Mode Mode Conversion Effort 
System/370 System /370 24-bit Least effort. Your application 
compatibility programs run as they do now, but 
they run only in System/370 mode. 
370-XA 370-XA 24-bit More effort because of 


toleration architectural differences between 
System/370 and 370-XA (such as 
PSWs, assembler instructions, and 
I/O). However, your programs 
cannot support 31-bit addressing. 


370-XA 370-XA 31-bit 


Most effort. Like 370-XA 
exploitation | toleration, 370-XA exploitation 
requires you to adapt your 
programs to 370-XA architecture. 
In addition, your programs can 
support 31-bit addressing. 


Note: When converting your CMS application programs, IBM encourages you to 
bypass the System/370 compatibility stage and go directly to the 370-XA toleration 
stage or, if possible, to the 370-XA exploitation stage. The reasons for this are: 


e The more conversions you perform, the more time and effort you will probably 
spend. Converting three times (to System/370 compatibility, then to 370-XA 
toleration, and then to 370-XA exploitation) will probably require more time 
and effort than converting once (directly to 370-XA exploitation). 


¢ CMS supports bimodal addressing. This allows programs running in 370-XA 
mode virtual machines to execute in 24-bit addressing mode, 31-bit addressing 
mode, or a combination of both. Therefore: 


— The same CMS used to run programs under 370-XA toleration can be used 
to run programs under 370-XA exploitation. 


- 370-XA toleration allows programs that require 24-bit addressing to run 
using a 370-XA mode virtual machine rather than a System/370 mode 
virtual machine. Therefore, end users need not be inconvenienced by having 
to know which mode their applications require (System/370 mode or 370-XA 
mode), and they do not have to re-IPL CMS when going back and forth 
between System/370 mode and 370-XA mode to accomplish their work. 


See VM/XA SP CMS Application Program Conversion Guide for details about 
bimodal addressing. 


¢ 370-XA exploitation allows you to move programs above the 16Mb line so that 
you can optimize the use of storage below the line. This is especially helpful for 
programs that require more addressing capability and storage than 24-bit 
addressing allows. 


204 VM/XA System Product Conversion Notebook 


RS ie ina Et a Sa es aa tg se a as San al tags ee ers Ue el ated tel te donne ey ee he dowel aes a nahi daliaialaiCln lithe ob ordi do 


VM/XA SF Conversion 


To relieve real storage constraints, CMS programs can use shared segments to 
share code and data. To relieve virtual storage constraints, CMS programs in 
discontiguous saved segments (DCSSs) can exploit extended addressing. 


An application program or licensed program in the 370-XA exploitation stage, 
as long as it satisfies all criteria for DCSS candidacy, can be put into a DCSS 
above the 16Mb line. This frees an equivalent space below the line for private 
code. 


An application program or licensed program in the 370-XA toleration stage, as 
long as it satisfies all criteria for DCSS candidacy, can be put into a DCSS 
below the 16Mb line but within the address range of a larger 370-XA mode 
virtual machine, callable from an application program or licensed program 
running under 370-XA exploitation. 


Certain kinds of programs need not be converted. They may continue to run in 
System/370 mode in a processor that is capable of 370-XA mode. Such 
programs include: 


— Programs that run in server machines but that have 370-XA mode 
application interfaces 

— Programs that serve a single user 

— Programs with a limited purpose, such as system setup. 


Programs that cannot run under 370-XA exploitation should, at a minimum, run 
under 370-XA toleration to facilitate program calling and exchange of data 
addresses within the same CMS virtual machine. These programs should be 
written in such a way as to isolate them from the underlying architecture. 


Conversion Checklist 


Commands. 


The syntax of most command invocations remains upwardly compatible. The 
format of many command responses has changed, particularly for the QUERY 
and SPOOL commands. To help you determine differences, IBM provides a 
sample EXEC called COMPSCAN SAMPEXEC, which flags commands and 
other keywords that might need to be changed. See Appendix A, “Conversion 
Tools” on page 277 for more information about COMPSCAN. See “VM/XA 
SF and VM/XA SP Command Compatibility” on page 213 for command 
comparisons. 


DIAGNOSE codes. 


Differences between the VM/XA SP CP and the VM/XA SF CP exist. 

Programs that use certain DIAGNOSE codes and/or CP commands may require 
modification. For instance, if your application program uses DIAGNOSE 
X'00' to determine the release level of CP, you must examine the program’s use 
of the licensed program bit map and change it, if necessary, to recognize 
VM/XA SP. You can use the sample EXEC COMPSCAN SAMPEXEC to 
determine differences. See Appendix A, “Conversion Tools” on page 277 for 
more information about COMPSCAN. 


Messages and return codes. 


The text of many messages has been improved for clarity and consistency. 
Approximately half of the 370-XA messages have changed message numbers. 
Return codes have also experienced extensive changes. Additionally, VM/XA 
SP has four-digit message numbers; therefore, some command invocations now 
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result in four-digit return codes. Applications that depend on 10-character 
message header lengths or 3- nee control program command return codes should 
be examined. 7 


See “VM/XA SF and VM/XA SP a Compatibility” on page 218 for 
message comparisons. 


Programs that operate on SPOOL files owned by another user must now refer to 
SPOOL files by user ID and oe ID. The CP SPOOL command 1 is enhanced 
for this support. 


VM/XA SP supports DOS simulation in a System/370 mode virtual Se 
only. 


VM/XA SP supports the VSE/VSAM functions supplied by the VM/SP Release 
5 CMS in a System/370 mode virtual machine only. 


VM/XA SP supports the EDIT command in a System/370 mode virtual machine 
only. The system product editor (XEDIT) runs in System/370 mode and in 
370-XA mode with 24-bit addressing. 


EXECs are upwardly compatible. Exceptions are EXECs that use CP 
commands or DIAGNOSE codes, which must be examined for compatibility. 
EXEC, EXEC 2, and REXX programs run only below the 16Mb line. 


The CMS DEBUG command is not supported. 


Programs that are architecture-specific (for example, programs that manipulate 
PSWs or issue I/O assembler instructions) require modifications to execute in 
CMS 370-XA mode virtual machines. The applications should continue to 
execute in CMS System/370 mode virtual machines. 


CMS must be IPLed in either System/370 mode or 370-XA mode. You can 
write dual-path application programs and EXECs, which follow one path for 
System/370 mode and a different path for 370-XA mode, or you can write a 
different version for each architecture. In the latter case you should give both 
versions the same name to minimize end-user confusion. You can do this with 
the NUCXLOAD command of CMS, using the form NUCXLOAD name fn, 
where name is the same in poll environments and fn is the unique System/370 or 
370-XA version. 


For application programs that must run in a specific mode (either System/370 or 
370-XA), you could write an EXEC to establish that mode automatically prior 
to invoking the application program. 


Changed CP Commands 


The response to the INDICATE USER command now separates general user 
information from virtual processor information. 
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Changed DIAGNOSE Codes 


| Store Extended-Identification Code (DIAGNOSE X'00') 
| A bit map is added for each release of VM/XA SP. 


| Virtual Console Function (DIAGNOSE X'08') 
| The XAUTOLOG command is added (to the LINK and AUTOLOG commands) as 
| a command for which CP can request or reject password entry. 


General I/O (DIAGNOSE X'‘20') 
DIAGNOSE X'20' now supports dedicated unit record devices. 


For entry values, register 5 contains the virtual device address and register 6 contains 
the channel address word (CAW). 


( - A new condition code is issued, condition code 0, in which case register 15 contains 
return code 0, indicating that the I/O completed successfully. 


CP Directory (DIAGNOSE X'3C') 
The interface is unchanged. However, the dees now brings the directory 
online if and only if one of the following is true: 


1. The new directory is on the same volume as the directory CP found at 
initialization time. In VM/XA SF, this volume had to be the system residence 
volume. 


( ‘ 2. DIRECTXA has not yet found a directory and the new directory is ona 
Kee CP-owned volume. 


| 3270 Virtual Console Interface (DIAGNOSE X'58') 


| Operation code X'49', for line mode operation, is new. 


Error Message Editing (DIAGNOSE X'‘5C') 
The entry values are the Rx, Rx+1, and Ry registers. 


( - The Rx register contains the address of the first byte of the message to be edited. 


If the subfunction code in the Ry register is X'40', the Rx register cannot be register 
15: 


Rx +1 contains the length of the message header if the subfunction code is X'40'. 


The Ry register now indicates: 


e The subfunction code 
e The length of the header (when applicable) 
e The length of the message. 


The high-order byte of the Ry register indicates the function requested: 


e A value of X'00' indicates that a 10-byte message header is assumed. The 
actual contents of the message header are not checked. 


~~ 


e A value of X'40' indicates that the length of the message header is being passed 
to the routine. The actual contents of the message are not checked. 
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e A value of X'20' indicates that the length of the message header must be 
calculated. Diagnose X'5C' assumes that the message header runs up to but 
does not include the first blank. It also assumes the text begins at the location 
following the first blank. | | 


Finding, ona and Purging a Discontiguous Saved Segment (DIAGNOSE X'64") 
When issued for a saved segment that has been defined as a member saved segment, 
the LOAD and FINDSEG functions in DIAGNOSE X'64' return the beginning 
and ending addresses that are on a page boundary, not necessarily a segment 
boundary. In VM/XA SF, these functions, since they returned the beginning and 
ending addresses of DCSSs, returned addresses on segment boundaries. If your 
program has a dependency on a segment boundary, use the DEFSEG command to 
place the program on a segment boundary. | 


A change to DIAGNOSE X'64' prevents the use of the LOADNSHR subcode to 
load a CP DCSS in which one or more page ranges have the SC descriptor code. 


Some exit error (condition code 2) return codes for DIAGNOSE X'64' have 
changed: 


¢ The VM/XA SF return code 301, X'12D' (a System/370 guest is not allowed to 
load a saved segment beyond 16Mb) is now return code 1357, X'54D'. 


e¢ The VM/XA SF return code 303, X'12F' (the saved segment would overlay an 
existing segment) is now return code 1351, X'547'. 


¢ The VM/XA SF return code 304, X'130' (unacceptable condition occurred) is 
now return code 1352, X'548'. | 


Saving and Loading a Named Saved Image File (DIAGNOSE X'74') 
DIAGNOSE X'74' now issues a new return code, X'30', to indicate that the 
maximum number of system spool IDs has been exceeded. The DIAGNOSE 
instruction results in return code X'2C' when the maximum number of spoolids for 
system data files has been exceeded. 


Message Compatibility 
See “VM/XA SF and VM/XA SP Message Compatibility” on page 218. 


New Functions That Do Not Affect Conversion 


The following new functions in VM/XA SP do not directly affect your conversion 
unless you decide to use them. To exploit these functions, be sure to read the other 
publications in the VM/XA SP library. 


e New functions on DIAGNOSE X'64': 


— The FINDSKEL function, which allows a program to install the code or 
data in the page areas defined in skeleton, class S, system data files. 


— The FINDSPACE function, which you can use to get the range associated 
with a segment space 


— Achange to the LOADNSHR subcode that prevents you from loading a CP 
DCSS in which one or more page ranges have the SC descriptor code. 
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¢ DIAGNOSE X'04', which allows you to examine any page in main storage, 
including pages not owned by CP 


| ¢ DIAGNOSE X'84', which allows you to replace certain data in any entry in the 
| user directory 


¢ DIAGNOSE X'70', a new time-of-day (TOD) clock accounting interface 


e DIAGNOSE X'B0', which allows you to obtain diagnostic information about 
the cause of an automatic reload (IPL) of your virtual machine 


| ¢ DIAGNOSE X'D4', which establishes an end user’s user ID as the originator of 
| spool files created while a worker machine is processing the end user’s request 


| e DIAGNOSE X'D8', which reads spool file blocks on the system spool file 
| queues 


| ¢ DIAGNOSE X'E0', which allows the owner of a system trace file to read trace 
| blocks sequentially from the file 


( = ¢ New IUCV CP system services: 


— The DASD block I/O system service (*BLOCKIO), which provides a virtual 
machine with device-independent access to its virtual count-key-data DASD 


| | ~ The CP system service (*CCS) that, in conjunction with the VTAM service 
| machine, provides SNA console support 


— The monitor system service (*“MONITOR), which allows a virtual machine 
to access system monitor data 


communicate with the Resource Access Control Facility (RACF) service 


/ — The access verification system service (*RPI), which allows CP to 
virtual machine when the RACF licensed program is installed 


— The CP system service (*SIGNAL) that allows virtual machines in a virtual 
machine group to signal each other. 


| e Additional parameters of the IUCV macro: 


| — ANSLIST on the SEND and REPLY functions (to indicate whether the 
| ANSBUF parameter contains an address or a list of addresses) 


s | —- BUFLIST on the SEND and RECEIVE functions (to indicate whether the 
( | BUFFER parameter contains an address or a list of addresses) 


| — CONTROL on the CONNECT function (to indicate whether the path is to 
| be a control path) and on the DCLBFR function (to indicate whether the 
| buffer is to be a control buffer). 


[| e The Monitor Call class 10 instruction, which allows a virtual machine to pass to 
| the control program a trace event record for recording in a system trace file. 
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Chapter 19. Diagnosis 


Diagnosis tasks include isolating, describing, reporting, and correcting failures in 
VM/XA SP. 


VM/XA SP introduces new and changed abend codes, new trace table entries, and 
minor changes to commands. 


Changed Trace Table Entries 


The following trace table entries have changed. See the VM/XA SP CP Diagnosis 
Reference for details. 


e Add to dispatch list trace entry 
es e Drop from dispatch list trace entry 
( ¢ Obtain free storage 
7 ¢ Obtain free storage extend frame 
¢ Return free storage 
e Return free storage extend frame. 


Differences Tracing the Control Program 
Two trace codes of the SET CPTRACE command have changed: 


( e F700—Return free storage extended frame 
bs ¢ F701—Obtain free storage extended frame. 


| The VM/XA SP TRSAVE command has more functions than the VM/XA SF 
| TRSAVE command, and has different defaults. 


Message Compatibility 
See “VM/XA SF and VM/XA SP Message Compatibility” on page 218. 


New Functions That Do Not Affect Conversion 


The following new functions in VM/XA SP do not directly affect your conversion 
unless you decide to use them. To exploit these functions, be sure to read the other 
publications in the VM/XA SP library. These new functions include: 


¢ Control block identifiers in free storage blocks help you find control blocks in a 
dump even if anchors or chains are not available. 


| e New trace table entries: 


— CCS ACCEPT 

— CCS PURGE 

— CCS RECEIVE 

— CCS REPLY 

CCS SEND lI-way 

— CCS SEND 2-way 

— CCS SEVER | 

— CCS logic error in CCS WEBBK 


m 
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— CCS REPLY from VSM 

— CCS CONNECT for VSM 

— CCS SEVER from VSM 

— CCS message complete 

—- CCS CONNECT for LU 

— CCS logic error in VSM WEBBK 
— CCS error in user environment 
— CCS soft abend VCX002 

— CCS ACCEPT error 

— CCS RECEIVE error 

— CCS REPLY error 

—- CCS SEND I-way error 

— CCS SEND 2-way error. 


¢ The command TRSOURCE traces virtual machine events. The command 
QUERY TRSOURCE displays the status of virtual machine event traces. 
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Chapter 20. VM/XA SF and VM/XA SP Compatibility Tables 


This chapter summarizes compatibility information for CP commands and messages. 


VM/XA SF and VM/XA SP Command Compatibility 


Table 27 contains compatibility information for VM/XA SF commands. The 
compatibility categories are: 


¢ Upwardly compatible with VM/XA SP. The command exists in both systems but 
there are differences in syntax, responses, and functions. Invocations and 
applications using the VM/XA SF command syntax should continue to execute 
unchanged. 


¢ Incompatible with VM/XA SP. The command exists in both systems but 
differences in syntax, responses, or functions may cause some invocations or 


applications using the previous syntax to execute incorrectly or not to execute at 
all. 


Any VM/XA SF command not listed in the table has a compatible VM/XA SP 
command. The command exists in both systems and has equivalent syntax, 
responses, or functions. | 


All commands and responses that use DISP in VM/XA SF use GRAF in VM/XA 
SP. 


Table 27 (Page | of 5). VM/XA SF and VM/XA SP Command Compatibility 


Corresponding VM/XA 
VM/XA SF Commands SP Commands Notes 


AUTOLOG AUTOLOG 


Incompatible. VM/XA SP AUTOLOG does not 
have keyword parameters. The primary system 
operator is no longer allowed to log on a user 
unless the operator has class A or B command 


privileges. Messages displayed for an incorrect 
password differ from VM/XA SF. 


A new command, XAUTOLOG, is upwardly 
compatible with AUTOLOG. In addition to the 
command name difference, it has additional 
operands. 


Incompatible. In VM/XA SP, the new spool ID 
is provided on the response when the file is 
changed to another user ID. Class D users are 
not allowed to specify SYSTEM and spoolid. 


CLOSE CLOSE Incompatible. In VM/XA SP, the response is 
different when the file is closed to another user 
ID, and the new spool ID is provided. 
DEFINE DISPLAY DEFINE GRAF DEFINE DISPLAY is a VM/XA SF-only 
| command. Use DEFINE GRAF instead. 
| DEFINE DISP DEFINE GRAF Incompatible. The VM/XA SP DEFINE GRAF 
| | response has GRAF instead of DISP. 
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Table 27 (Page 2 of 5). VM/XA SF and VM/XA SP Command Compatibility 


Corresponding VM/XA | 
SP Commands Notes _ 


DETACH vdev Incompatible. The VM/XA SP DETACH | 
response does not have DASD. 
DIAL | DIAL Incompatible. The VM/XA SP DIAL responses 


are different and type rdev is omitted from the 
DISPLAY DISPLAY Incompatible. VM/XA SP DISPLAY has a 
| different default format and has different 
| rounding boundaries (hex 10 for translated 
| output and fullword for untranslated output). 


beginning of responses. 
DISPLAY GUEST DISPLAY GUEST Incompatible. By default, VM/XA SP 
STORAGE STORAGE DISPLAY GUEST STORAGE displays guest 
| real storage rather than guest logical storage. 


Incompatible. The VM/XA SP DISPLAY 
REGISTERS response has GPR instead of G, 
FPR instead of Y, and CR instead of X. 


DRAIN DRAIN Incompatible. A third line appears in the 
response for impact printers other than the 1403. 


DUMP DUMP Incompatible. VM/XA SP DUMP has a 
different default format and has different 
rounding boundaries (X'10' for translated 
output and fullword for untranslated output). 


DUMP GUEST DUMP GUEST Incompatible. By default, VM/XA SP DUMP 
STORAGE STORAGE GUEST STORAGE dumps guest real storage 
rather than guest logical storage. VM/XA SP 
dumps registers and then status when any guest 
storage is dumped. VM/XA SF dumped 
registers and storage only when all guest storage 
was dumped. 


Incompatible. The VM/XA SP DUMP 
REGISTERS response has GPR instead of G, 
FPR instead of Y, and CR instead of X. 


FORCE FORCE Incompatible. The VM/XA SP FORCE 
| response has GRAF instead of DISP and DSC 
instead of DISC. 
INDICATE ‘INDICATE Incompatible. The VM/XA SP INDICATE 
response is different. 


ORDER ORDER Incompatible. The privilege class DORDER 


command no longer allows the spoolid operand 
PURGE 


with the SYSTEM operand. Responses to the 
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DETACH vdeyv 


DISPLAY REGISTERS | DISPLAY REGISTERS | 


DUMP REGISTERS DUMP REGISTERS 


privilege class D and G ORDER command that 
indicate the number of files ordered now have 
up to a seven-digit number. 


Incompatible. VM/XA SP PURGE does not 
allow class D users to specify SYSTEM or 
spoolid. 


VM/XA SF Conversion 


Table 27 (Page 3 of 5). VM/XA SF and VM/XA SP Command Compatibility 


Corresponding VM/XA 
Notes 


SP Commands 

QUERY FILES Incompatible. VM/XA SP QUERY FILES does 
not allow class D users to specify SYSTEM or 

spoolid. 


QUERY HOLD QUERY HOLD Incompatible. VM/XA SP QUERY HOLD 
provides different information. You must 
specify the LOG operand to display users whose 
logon is in hold status. 


QUERY IMG QUERY IMG Incompatible. The format of the response has 
changed. 


QUERY LOGMSG QUERY LOGMSG Incompatible. VM/XA SP QUERY LOGMSG 
| does not display a header line and issues a 
response if there is no log message data. 


QUERY NAMES QUERY NAMES Incompatible. The VM/XA SP QUERY 
NAMES response has DSC instead of DISC. 

QUERY NSS QUERY NSS Incompatible. The format of the response has 
changed. 

QUERY NSS MAP QUERY NSS MAP Incompatible. The format of the response has 
changed. 


QUERY PFnn QUERY PFzan Incompatible. VM/XA SP QUERY PFnn does 


not display saved lines under a PF key that is set 
to RETRIEVE. Also, the command no longer 

QUERY PRINTER QUERY PRINTER 

ALL ALL 


VM/XA SF Commands 
QUERY FILES 


responds with “ALL PFS UNDEFINED.” 


Incompatible. VM/XA SP QUERY PRINTER 
ALL does not allow class D users to specify 
SYSTEM or spoolid. 


Incompatible. VM/XA SP QUERY PUNCH 
ALL does not allow class D users to specify 
SYSTEM or spoolid. 


Incompatible. VM/XA SP QUERY READER 
ALL does not allow class D users to specify 
SYSTEM or spoolid. 


QUERY REAL QUERY REAL Incompatible. VM/XA SP displays a third line 
DEVICE DEVICE for impact printers. 


QUERY REAL STOR QUERY REAL STOR Incompatible. The VM/XA SP QUERY REAL 
QUERY FRAMES STOR response is different; it 1s similar to the 
VM/XA SF QUERY FRAMES response. 


Incompatible. VM/XA SP QUERY SDF does 
not have the CLASS operand. The command 
responds with the number of UCR files. 


Incompatible. VM/XA SP QUERY SRM does 
not have the USER userid operand; QUERY 
SHARE does instead. 


QUERY PUNCH ALL QUERY PUNCH ALL 


QUERY READER 
ALL 


QUERY READER 
ALL 


QUERY SDF QUERY SDF 


QUERY SRM QUERY SRM 


QUERY SHARE 


Chapter 20. VM/XA SF and VM/XA SP Compatibility Tables 215 


VM/XA SF Conversion 


Table 27 (Page 4 of 5). VM/XA SF and VM/XA SP Command Compatibility : 


: f 
| Corresponding VM/XA iy 
VM/XA SF Commands SP Commands | Notes > | a 
QUERY SYSTEM QUERY SYSTEM Incompatible. The VM/XA SP QUERY 
SYSTEM responses are different. 
| QUERY TAG QUERY TAG Incompatible. The VM/XA SP QUERY TAG 
| response is different. 


QUERY TERMINAL QUERY TERMINAL Incompatible. The VM/XA SP QUERY 
TERMINAL response has “BRKKEY PFO1, ..., 
PFO9” instead of “BRKKEY PF1, ..., PF9.” 


QUERY UR ATTACH | QUERY UR ATTACH | Incompatible. The VM/XA SP QUERY UR 
ATTACH response has one space between the 
device name and device address. 


QUERY VIRTUAL QUERY VIRTUAL Incompatible. The VM/XA SP QUERY _ 
CONSOLE CONSOLE VIRTUAL CONSOLE response is different. oo 
QUERY VIRTUAL QUERY VIRTUAL Incompatible. The VM/XA SP QUERY 
DASD DASD VIRTUAL DASD response 1s different. 
QUERY VIRTUAL QUERY VIRTUAL Incompatible. QUERY VIRTUAL DISPLAY 
DISPLAY GRAF is a VM/XA SF-only command. Use QUERY 
VIRTUAL GRAF instead. The VM/XA SP 
QUERY VIRTUAL GRAF response has 
GRAF instead of DISP. 
QUERY VIRTUAL QUERY VIRTUAL Incompatible. The VM/XA SP QUERY ( \ 
PRINTER PRINTER VIRTUAL PRINTER response contains PRT +7 
rather than DEV. 
QUERY VIRTUAL QUERY VIRTUAL Incompatible. The VM/XA SP QUERY 
PUNCH PUNCH VIRTUAL PUNCH response contains PUN 
| rather than DEV. 
QUERY VIRTUAL QUERY VIRTUAL Incompatible. The VM/XA SP QUERY 
READER READER VIRTUAL READER response contains RDR 
rather than DEV. ie 


\ 
RESET RESET Incompatible. The VM/XA SP RESET response ” 
| is different. | 
REWIND REWIND Incompatible. The VM/XA SP REWIND 
responses are different. 


SAVESEG 7 SAVESEG The addition of CP saved segments adds 


restrictions on the saving of saved segments 
(both CP and non-CP) with the same name. 

SAVESYS SAVESYS 
| SET ACNT SET ACNT 


216 VM/XA System Product Conversion Notebook 


The addition of CP saved segments adds 
restrictions on the saving of named saved 
systems (both CP and non-CP) with the same 
name. 


Incompatible. Issuing SET ACNT in VM/XA 
SP results in a message stating that the 
command is not supported, instead of being 
treated as a NO-OP as in VM/XA SF. 


( 


| 
| 
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Table 27 (Page 5 of 5). VM/XA SF and VM/XA SP Command Compatibility 


Corresponding VM/XA 
VM/XA SF Commands SP Commands Notes 
SET CCWTRAN SET NOTRANS SET CCWTRAN is a VM/XA SF-only 
command. Use SET NOTRANS instead. 
SET MITIME SET MITIME GRAF SET MITIME DISPLAY is a VM/XA SF-only 
DISPLAY command. Use SET MITIME GRAF instead. 
SET SRM SHARE SET SHARE Incompatible. SET SRM SHARE is replaced by 
SET SHARE. The ABSCPU option is invalid. 


STORE GUEST STORE GUEST 
STORAGE STORAGE 


TERMINAL TERMINAL 


TRANSFER TRANSFER 
TRSAVE > TRSAVE 


SHUTDOWN SHUTDOWN A privilege class A user other than the primary 
system operator can issue SHUTDOWN. In 
such a case, the response “SYSTEM 
SHUTDOWN STARTED” goes to both the 

is invoker and the primary system operator. 
— 


SPTAPE SPTAPE 


START START 


Incompatible. VM/XA SP SLEEP always issues 
a return code of 0 when the command is valid, 
even if the user cancels the command before it 
finishes; VM/XA SF issues a return code of 2. 


Incompatible. VM/XA SP SPTAPE requires a 
user ID to be specified with a spool ID. 


Incompatible. You must specify NOSEP on 
each START command if you do not want 
separator pages printed. In VM/XA SF, 
NOSEP remained in effect until the SEP option 
was specified on another START command. 


Incompatible. By default, VM/XA SP STORE 
GUEST STORAGE stores into guest real 
storage rather than guest logical storage. 


Incompatible. VM/XA SP TERMINAL does 
not have these operands: LINEDIT, MSG, 
WNG, EMSG, and IMSG. 


A virtual machine reset no longer resets the 
value established by the TERMINAL 
CONMODE command. 


Incompatible. The VM/XA SP TRANSFER 
response has the new spool ID. You cannot 
specify SYSTEM and the user ID on the same 
command line. 


Incompatible. The defaults are different and the 
VM/XA SP TRSAVE command has more 
functions. 
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VM/XA SF and VM/XA SP Message Compatibility 


Table 28 compares messages that are incompatible between VM/XA SF and 
VM/XA SP. Incompatible messages are those that have the same number in both 
systems but have different texts, which could cause applications that depend on 
message texts to execute incorrectly or not to execute at all. 


VM/XA SF messages that are not listed in the table are: 


¢ Compatible messages. The message number exists in both systems and has the 
same message text. 


e VM/XA SF-only messages. 
e VM/XA SP-only messages. 


VM/XA SF and VM/XA SP Incompatible Messages 


Table 28 (Page 1 of 17). 


No. 
0001 


0002 
0003 
0004 
0005 


0006 


0007 
0008 
0009 
0010 
0011 
0012 
0013 


0018 


System 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 
VM/XA SF 
VM/XA SP 
VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


Text 


2CP: command 
Unknown CP command: command 


INVALID OPERAND operand 
Invalid operand - operand 


INVALID OPTION option 
Invalid option - {eption|command contains extra option(s) starting with option} 


INVALID HEXLOC hexloc 
Invalid hexloc - hexloc 


INVALID HEXDATA hexdata 
Invalid hexdata - hexdata 


INVALID DEVICE TYPE {rdev|vdev|ldev} 
[Invalid device type - {rdev|vdev|ldev}|] or [INVALID DEVICE TYPE 
{rdey|vdev|ldev}| 


INVALID USERID userid 
Invalid userid - userid 


INVALID SPOOLID spoolid 
Invalid spoolid - spoolid 


INVALID RANGE |range| 
Invalid range - range 


INVALID REGISTER register 
Invalid register - register 


INVALID DEVICE TYPE - userid vdev 
Invalid device type - userid vdev 


INVALID PSW psw 
Invalid PSW - psw 


CONFLICTING OPTION option 
Conflicting option - option 


SPOOLID MISSING 
Spoolid missing | 
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No. 
0019 


0020 
0021 
0022 
0023 
0024 
0025 
0026 
0028 
0030 
0031 
0033 
0035 
0036 
0038 


0039 


0040 
0041 
0042 


0043 


System 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 
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Table 28 (Page 2 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


Text 


COMMAND PROCESSOR NOT LOADED 
The system command processor is not loaded. 


USERID MISSING 
Userid missing or invalid 


RDEV MISSING OR INVALID 
A real device number was not supplied or it is invalid. 


VDEV MISSING OR INVALID 
A virtual device number was not supplied or it was invalid. 


VOLID MISSING OR INVALID 
VOLID missing or invalid 


CYLINDERS MISSING OR INVALID 
Cylinders missing or invalid 


STORAGE MISSING OR INVALID 
Storage missing or invalid 


OPERAND MISSING OR INVALID 
Operand missing or invalid 


CLASS MISSING OR INVALID 
Class missing or invalid 


INVALID NUMBER FOR option operand 

Copies missing or invalid 

OPTION MISSING 

Buffer missing or invalid; extended FCB not supported 


HEXLOC MISSING OR INVALID 
Hexloc missing or invalid 


DEVICE TYPE MISSING OR INVALID 
Device type missing or invalid 


INDEX MISSING OR INVALID 
Index missing or invalid 


FORMAT OPERAND MISSING 
Parameter for option option missing or invalid - parameter 


command COMMAND FOR CPU nn INVALID; CPU IN CHECK-STOP 
STATE 
Processor address missing or invalid 


DEVICE {rdev|vdev|[dev} DOES NOT EXIST 
Device {rdev|vdey|l[dev} does not exist 


LOGMSG an DOES NOT EXIST 
Logmsg mn does not exist. 


SPOOLID nnnn DOES NOT EXIST 
User userid spoolid nnnn does not exist 


BUFFER name DOES NOT EXIST 
Buffer buffer does not exist 
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Table 28 (Page 3 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


No. 
0044 


0045 
0046 
0047 
0049 
0050 
0052 
0053 


0054 


0055 
0056 


0057 


0058 


0059 


0060 
0061 
0067 
0068 


0088 


System 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


Text | 
SYSTEM name DOES NOT EXIST 


System {name|volume} does not exist 


userid NOT LOGGED ON 
userid not logged on 


type rdev OFFLINE 
type rdev offline 


userid vdev DOES NOT EXIST 
userid vdey does not exist 


type rdev IN USE 
type vdev in use 


PASSWORD INCORRECT 
LOGON unsuccessful--incorrect password 


ERROR IN CP DIRECTORY 
[XAUTOLOG failed for userid:] Error in CP directory 


userid NOT IN CP DIRECTORY 
[XAUTOLOG failed for userid:] userid not in CP directory 


ALREADY LOGGED ON {DISP rdev|DISP /dev|DISC} | 
[XAUTOLOG failed for userid: ] Already logged on {type vdev| LUNAME 
vdev| disconnected} 


LINE(S) NOT AVAILABLE ON userid 
Line(s) not available on userid 


LINE vdev BUSY ON userid 
Line vdev busy on userid 


userid NOT RECEIVING; {DISCONNECTED|MSG OFF|WNG OFF|SMSG 
OFF|NOT AUTHORIZED|QUIESCED|MSG TOO LONG/VMCF ERROR 
nnnn|TUCV ERROR nnnn} VMCF ERROR znn} 

userid not receiving; text 


CTCA vdev BUSY ON userid 
CTCA vdev busy on userid 


AUTOLOG FAILED FOR - userid a 
{XAUTOLOG|AUTOLOG} failed for userid - {IPL missing|IPL failed|accounting 
errors|incorrect password} | 


DUMP FAILED; VIRTUAL PRINTER UNAVAILABLE 
{Dump failed|Printer output terminated}; virtual printer unavailable 


DUMP FAILED; VIRTUAL PRINTER ERROR 
Dump failed; virtual printer error 


DUMP FAILED; SPOOLING ERROR 
Command format not valid 


INVALID FORMAT OPERAND -vmtype 
SEND command failed; text 


INVALID COUNT FOR option operand 
An invalid number was supplied for {COPY|FLASH} - operand. 
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Table 28 (Page 4 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


No. 
0090 


0091 


0092 


0094 


0095 


0101 


0102 


0103 


0104 


0105 


0106 


0107 


0108 


0109 


0110 


~6CO11I 


O112 


0113 


0114 


System 
VM/XA SF 


VM/XA SP - 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF - 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 
VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


Text 


DEVICE vdev NOT DEFINED; DEVICE {rdev|volser} NOT AVAILABLE 
Device vaddr not defined; device {raddr|volser} not available 


DASD vdev NOT DEFINED; TEMPORARY SPACE NOT AVAILABLE 
DASD vdev not defined; temp space not available 


type vdev NOT DEFINED; type vdev ALREADY DEFINED 
DEVICE vdev NOT DEFINED; device vdev ALREADY DEFINED 


STORAGE REQUESTED EXCEEDS ALLOWED MAXIMUM OF nnn MEG 
Storage exceeds allowed maximum of nnn MEG 


DEVICE vdev NOT DEFINED; MAXIMUM NUMBER OF DEVICES 
ALREADY DEFINED 
Device vaddr not defined; insufficient free storage 


DASD vdev FORCED R/O; R/O BY {nnn USERS|userid} 
DASD vdev forced R/O; R/O by {nnnn users|userid} 


DASD vdev FORCED R/O; R/W BY {nnn USERS|userid} 
Dasd vaddr forced R/O; R/W by {nnnn users|userid} 


DASD vdev FORCED R/O; R/W BY {nnn USERS|userid}; R/O BY {nnn 
USERS|userid} i 
DASD vdev forced R/O; R/W by {nnnnn users|userid}; R/O by {nnnnn users|userid} 


userid vdev NOT LINKED; R/O BY {nnn USERS|userid} 
userid vdev not linked; R/O by {nnnnn users|userid} 


userid vdev NOT LINKED; R/W BY {nnn USERS|userid} 
userid vdev not linked; R/W by {nnnn users|userid} 


userid vdev NOT LINKED; R/W BY {nnnUSERS|userid}; R/O BY {nnn 
USERS|userid} 
userid vdev not linked; R/W by {nnnnn users|userid}, R/O by {nnnnn users|userid} 


userid vdevNOT LINKED; NOT IN cP DIRECTORY 
userid vdev not linked; not in CP directory 


userid vdevNOT LINKED; VOLID volid NOT MOUNTED 
userid vdev not linked; volid volid not mounted 


userid vdev NOT LINKED; INVALID LINK DEVICE 
userid vdev not linked; invalid link device 


userid vdev NOT LINKED; type v\dev ALREADY DEFINED 
userid vdev not linked; type vdev already defined 


userid vrdevNOT LINKED; NO READ PASSWORD 
userid vdey not linked; no read password 


userid vdev NOT LINKED; NO WRITE PASSWORD 
userid vdev not linked; no write password 


userid vdev NOT LINKED; NO MULT PASSORD 
userid vdey not linked; no multiple password 


userid vdev NOT LINKED; PASSWORD INCORRECT 
userid vdev not linked; mode or password incorrect 
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VM/XA SF Conversion 


Table 28 (Page 5 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


No. 
0115 


0117 


0153 


System 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 
VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 
VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 
VM/XA SF 


VM/XA SP 


Text 


LINK INVALID; EXCESSIVE INCORRECT PASSWORDS 
{LINK|AUTOLOG|XAUTOLOG} invalid; excessive incorrect passwords 


userid vdev HAS NOT BEEN LINKED BECAUSE VOLUME volid IS NOT ON 
THE SPECIFIED TYPE OF DEVICE 
Userid userid not linked; volid volid conflict 


userid vdev NOT LINKED; COMMAND FORMAT NOT VALID 
userid vdev not linked; command format not valid 


type {rdev|ldev=} NOT ATTACHED; userid vdev ALREADY DEFINED 
type {rdev|ldev} not attached; userid vdev already defined 


type {rdev\ldev} NOT ATTACHED TO userid 
type {rdev|ldev} not attached to {userid|system} 


type {rdev\ldev} ALREADY ATTACHED TO userid 
type {rdev|ldev} already attached to userid 


DASD rdev CP OWNED 
DASD rdev CP-owned 


DASD rdev IN USE BY nann VIRTUAL DEVICE(S) 
DASD rdeyv in use by nnnnn users 


DASD rdev VOLID volid ALREADY ATTACHED TO SYSTEM 
DASD rdeyv volid volid already attached to system 


DASD rdev ERROR READING VOLID 
DASD rdev error reading volid 


DASD rdev VOLID volid DOES NOT MATCH 
DASD rdey volid volid does not match © 


DASD rdev ERROR READING ALLOCATION RECORD 
DASD rdey error reading allocation record 


type {rdev\ldev} ATTACHED TO userid 
type {rdev|ldev } attached to userid 


type rdev NOT ACTIVE © 
type rdev not active 


type rdev NOT DRAINED 
type rdev not drained 


type rdev IN USE BY SYSTEM 
type rdev in use by system 


rdev BUFFER LOAD name FAILED 
Printer rdev buffer load name failed 


userid vdev HAS NOT BEEN LINKED BECAUSE IT IS NOT WITHIN CP 
VOLUME CYLINDER EXTENTS 
{PFCOPY|PFTAB} not available 


userid vdev HAS NOT BEEN LINKED BECAUSE IT WOULD OVERLAP 
SYSTEM type SPACE | 
Device {vdev|RANGE} exceeds maximum number of virtual devices 
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Table 28 (Page 6 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


No. 
0155 


0160 


0163 


0164 


0167 


0170 


0174 


0177 


0180 


0196 


0197 


0200 


0202 


0203 


0204 


0205 


0206 


0232 


0240 


System 
VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


Text 


DEVICE rdev HAS NOT BEEN ATTACHED TO THE SYSTEM BECAUSE IT 
IS NOT A DASD DEVICE 
Device rdev has not been attached to the system because it is not a DASD device. 


HEXLOC hexloc EXCEEDS STORAGE 
Hexloc hexloc exceeds storage 


STORE EXCEEDS MAXIMUM REGISTER 
STORE exceeds maximum register 


HEXLOC hexloc NON-ADDRESSABLE STORAGE 
Hexloc hexloc non-addressable storage 


INVALID MASK FOR DATA RANGE SPECIFIED 
The mask is invalid for the specified data range. 


SYSTEM name EXCEEDS STORAGE SIZE; {nnn K|nnnM} REQUIRED 
System name exceeds storage size; {nnnnnnnnK |nnnM} required 


PAGING I/O ERROR; IPL FAILED 
Paging I/O error; IPL failed 


PARM EXCEEDS 64 CHARACTERS 
Your PARM data exceeds the limit of nn characters. Correct your data string and 
reissue the IPL command. 


TRACE NOT IN EFFECT 
Trace not in effect 


SHARED NOT SET {ON|OFF} FOR type rdev; NOT A SHARED DEVICE 
Secondary user not in CP directory 


SHARED NOT SET {ON/OFF} FOR type rdev ; DOES NOT SUPPORT 
RESERVE/RELEASE 
Secondary user is not available 


VIRT= REAL AREA NOT AVAILABLE; IN USE BY {userid|SYSTEM} 
Virtual = Real area not available; in use by {userid|nnnn user(s)} 


VIRT =REAL AREA NOT AVAILABLE; INSUFFICIENT 
Virtual = {Real|Fixed} area not available; insufficient storage 


V=R AREA REQUIRES IPL BY DEVICE NUMBER 
Virtual = {Real|Fixed} area requires IPL by device number 


INVALID PAGE(S) SPECIFIED, V=R AREA 

Invalid page(s) specified - Virtual = Real area 

VIRT=REAL AREA NOT GENERATED 

The virtual = real area is not available because it was not generated. 


VIRT=REAL AREA NOT AVAILABLE; UNLOCKED 
Cannot connect to host virtual machine 


IPL UNIT ERROR; {CSW = csw|IRB = irb}, SENSE = sense 
IPL UNIT ERROR, {CSW = csw|IRB = irb}, SNS = sense 


PRT rdev FCB fcb DOES NOT MATCH FORM LENGTH; FILE spid 
{HELD|PURGED|FLUSHED|REQUEUED/|CLOSED} 

The form length mounted on printer rdev does not match the length described by 
the FCB fcb. 
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VM/XA SF Conversion 


Table 28 (Page 7 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


No. 
0241 


0247 


0255 


Q259 


| 0260 


| 0261 


| 0262 


| 0263 


| 0264 


| = 0266 


| = 0267 


0270 


| 0289 


| 0295 


0298 


| 0299 


| 0300 


System 
VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


Text 


PRT rdev UNDEFINED LOAD IMAGE imagname SPECIFIED; FILE spid 
{HELD|PURGED|]REQUEUED|CLOSED} 
An undefined load image imagename was specified for sinter rdey. 


3800 NAMED IMAGE imagname CREATED 
NAMED IMAGE imagename CREATED 


PRT rdev WAS RESET AND nann PAGES WERE LOST | 
PRINTER rdev; PAGE BUFFER DESTROYED, BACKUP PAGE COUNT = 
nnnn 


type rdev REQUIRES OPERATOR INTERVENTION DUE TO A LINE 
OVERRUN CONDITION 
SIZE parameter missing or invalid 


COMMAND |command| ENDED DUE TO ERRORS 
{Command|SPTAPE command|command command} processing cannot complete 
due to errors. 


INVALID KEY key 
key is an invalid storage key. 


VIRTUAL CONSOLE NOT DEFINED 
The virtual console is not defined or is detached. 


TOO MANY OPERANDS IN COMMAND LINE 
Too many operands were supplied for this command. 


OPTION(S) IGNORED; option(s) 
One or more options are ignored during reconnect processing - option(s) 


ACCOUNT NUMBER MISSING OR INVALID 
An account number was not supplied or is invalid. 


SCHIB MISSING OR INVALID 
A subchannel number was not supplied or is invalid. 


ACCOUNTING ERROR 
The character sets specified for the printer rdev required more writable character 
generation modules than were available. 


DEVICE vdev NOT DEFINED; MAXIMUM NUMBER OF DEVICES 
ALREADY DEFINED 
{User|Group} {userid|group: already enabled by traceid traceid. 


INVALID PAGE(S) SPECIFIED, NOT CP PAGEABLE 
The specified pages cannot be locked or unlocked because they are not in the CP 
pageable area. 


TRAP LIMIT EXCEEDED; COMMAND REJECTED 
userid vdev not linked; request denied 


{SEGMENT|SYSTEM} NOT DEFINED; SKELETON ALREADY EXISTS. 
The {Named Saved System (NSS)|saved segment} name could not be defined 
because a class S file with the same name already exists. 


SAVE REQUEST BEYOND VIRTUAL MACHINE SIZE 
Save request beyond virtual machine size 
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VM/XA SF Conversion 


Table 28 (Page 8 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


No. 
0310 


0315 


0320 


0321 


0322 


()323 


0324 


0325 


0326 


0332 


0339 


0353 


0361 


0362 


0386 


System 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 
VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


Text 


DATE date INVALID; NOT CHANGED 
Date date invalid; not changed 


INVALID MODE - MUST BE 370 
THE CPFORMAT COMMAND REQUIRES THE VIRTUAL MACHINE TO 
BE IN 370 MODE. 


ALTERNATE PROCESSOR INITIALIZATION UNSUCCESSFUL 
SUBSYSTEM PROCESSING ERROR - FAULT CODE = code-raddr/ss-xx-xx 


PROCESSOR QUIESCED -- VARY OFFLINE 
DASD rdev SUBSYSTEM STORAGE EQUIPMENT CHECK - FAULT CODE 
= code-ss-XX-XX 


FAILING PROCESSOR QUIESCED 
DASD rdev SUBSYSTEM STORAGE AVAILABILITY THRESHOLD 
CROSSED-ss-XX-XX 


PROCESSOR QUIESCED FOR SYSTEM TERMINATION 
DASD rdev SUBSYSTEM STORAGE IS UNUSABLE - FAULT CODE = 
code-ss-XX-XX 


NO SPECIFIC TRACE IN EFFECT 
DASD rdev SUBSYSTEM MUST BE INITIALIZED - FAULT CODE = 
code-ss-X X-XX 


NO SPECIFIC TRACE IN EFFECT FOR 
DASD rdev STORAGE DIRECTOR COMMUNICATION FAILED - FAULT 
CODE = code-ss-XX-XX 


XSTORE NOT AVAILABLE. ALREADY IN USE [BY USER-userid] 
DASD rdev TRACK FORMAT NOT SUPPORTED FOR PAGING - ss-XX-XX 


CPU nn (BASE) IS NOT DETACHED 
Invalid control unit type - rdev 


INVALID PAGE DESCRIPTOR CODE invalid code FOR RANGE nannn-nnnnn 
SEGM 

The command processing cannot complete because the page descriptor code 
invalid-code for the page range 


SYSRES DEVICE rdev NOT FOUND 
Sysres device type invalid or device rdev not operational 


DEVICE rdey CANNOT BE VARIED ONLINE BECAUSE A TIME-OUT 
CONDITION OCCURRED. 
{XAUTOLOG failed for userid:} LOGOFF/FORCE pending for user userid 


DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE THE 
SUBCHANNEL-ID IS INVALID. | 

[Device rdev cannot be varied online because the subchannel-id is invalid.] or 
[DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE THE 
SUBCHANNEL-ID IS INVALID.] 


DASD vydev IS READ ONLY 
FORMATTING CANNOT BE DONE ON DASD ydev BECAUSE IT IS 
READ-ONLY. 
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VM/XA SF Conversion 


Table 28 (Page 9 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


No. 
0387 


0388 


0389 


0396 
0400 
0401 
0405 
0406 
0407 
0408 
0412 
0413 
0415 
0416 
0417 
0418 
0419 
0421 


0422 


System 


VM/XA SF | 


_VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 
VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 
VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


Text 


INVALID CONSOLE vdev FOR CPFORMAT -MUST BE A 3 DIGIT DEVICE 


ADDRESS 


THE CPFORMAT COMMAND REQUIRES A 3-DIGIT DEVICE NUMBER 


FOR THE VIRTUAL CONSOLE vdey. 


CPFORMAT CANNOT BE ISSUED BY A V=R USER 
CPFORMAT cannot be issued by a Virtual = {Real|Fixed} user. 


CYLINDER RANGE TOO LARGE - DEVICE vdev HAS nnn CYLINDERS 
THE CYLINDER RANGE IS TOO LARGE BECAUSE DEVICE vdev HAS © 


nnnn CYLINDERS. 
CPFORMAT TERMINATED 


THE CPFORMAT COMMAND PROCESSING DID NOT COMPLETE. 


SYSTEM {SPOOLING|PAGING} AREA FULL 

All {paging|spooling} space is in use. 

SYSTEM {SPOOLING|PAGING}AREA 90 PERCENT FULL 
90 percent of all {paging|spooling} space is in use. 


MOUNT FORM operform ON {PRT|PUN} rdev 
Mount form operform on {printer|punch} rdev 


SETUP FORM operform ON PRT rdev FOR FORMS ALIGNMENT CHECK 


Check forms alignment for form operform on printer rdev. 


NO FILES {SCANNED|DUMPED|LOADED} FOR SPTAPE ON DRIVE rdev 


No files were {scanned|dumped|loaded} for SPTAPE on drive rdev. 


INPUT TAPE ON DRIVE rdev IS NOT IN SPTAPE FORMAT 
The input tape on drive rdev is not in SPTAPE format. 


SPTAPE UNRECOVERABLE I/O ERROR ON DRIVE rdev 
An unrecoverable I/O error occurred on the SPTAPE tape drive rdey. 


COMMAND ENDED DUE TO SPOOL PAGING ERROR 
Command processing cannot complete due to a spool paging error. 


CONTINUOUS PAGING ERRORS ON VOLUME volser 


Six continuous paging errors have occurred on DASD nnnn volume volser. 


SPTAPE func FUNCTION ON DRIVE rdev TERMINATED 
The SPTAPE func function on drive rdev did not complete. 


{rdev|\vdev} NOT AN OUTPUT SPOOLING DEVICE 
{rdev/vdev} is not an output spooling device. 


{rdev|vdev} NOT A SPOOLED DEVICE 
{rdev/vdev\ is not a spooled device. 


{rdev|vdev' NOT A SPOOLED PRINTER 
{rdev/vdev} is not a spooled printer. 


PRT prt-type DOES NOT SUPPORT feature|command 


_ Printer prt-type does not support the {feature feature|command command}. 


CONFLICTING OPTION; SAME OPTION SPECIFIED TWICE 
The same option was specified twice. 
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Table 28 
No. 
0423 


0427 


0428 


0429 


0431 


0432 


0433 


0435 


0439 


0440 


0445 


0446 


0447 


0448 


0449 


0450 
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VM/XA SF Conversion 


(Page 10 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


System 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 


VM/XA SP 
VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


Text 


CONFLICTING OPTION; INCOMPATIBLE WITH PRIOR OPERAND 
The function requested is incompatible with a previously-specified operand. 


{CON|PRT|PUN|RDR|NSS|TAPE} {rdev|vdev|jname} SYSTEM SPOOL SPACE 
FULL; FILE {HELD|PURGED} 
type {rdev\vdev|name} system spool space full; file {closed|held|purged} 


{PRT|PUN|RDR|TAPE} rdev SPOOL ERROR; FILE {HELD|PURGED} 
type rdev spool error; file {held|purged|closed} 


{CONS|PRT|PUN|RDR} vdev SPOOL ERROR; FILE {HELD|PURGED} 
type vdev spool error; file {held|purged} 


RDR rdev ID CARD MISSING OR INVALID 
Reader rdey id card missing or invalid 


RDR rdev ID CARD INVALID; userid NOT IN CP DIRECTORY 
The ID card for reader rdev is invalid because userid is not in the CP directory. 


RDR rdev ID CARD; INVALID DATA data 
Reader rdev id card; invalid data - data 


PAGING I/O ERROR OCCURRED WHILE WRITING A PAGE. 
{DEFSYS|DEFSEG|SAVESYS|SAVESEG} COMMAND NOT COMPLETED. 
[{SAVESYS|SAVESEG} command was not completed because a paging I/O error 
occurred while writing a page.] or [{{[DEFSYS|DEFSEG} command processing 
cannot complete because a paging I/O error occurred while writing a page. | 


NO SPOOL FILE ID NUMBERS AVAILABLE 
{User userid|*NSS|*IMG|*UCR|*NLS} spool fileid limit exceeded 


{SEGMENT|SYSTEM} name {DEFINED|SAVED} SUCCESSFULLY IN 
FILEID (/fileid. 

{Named Saved System (NSS)|saved segment} name was successfully 
{saved|defined} in fileid 


{SEGMENT|SYSTEM} name COULD NOT BE {DEFINED|SAVED} DUE TO 
AN UNEXPECTED ERROR. 

The {Named Saved System (NSS)|saved segment} name could not be 
{saved|defined} due to an unexpected error. 


{SEGMENT|SYSTEM} name NOT PREVIOUSLY DEFINED AND CANNOT 
BE SAVED 

The {Named Saved System (NSS)|saved segment} mame was not previously defined 
and cannot be saved. | 


SYSTEM sysname CANNOT BE IPLED DUE TO INVALID PROCESSOR 
CONFIGURATION | 
System sysname cannot be IPLed due to an invalid processor configuration. 


SYSTEM name NOT QUIESCED. OUTSTANDING {I/O ON DEVICE 
vdev| EXTERNAL INTERRUPT}. 
System name not quiesced. Outstanding I/O on device rdev. 


YOUR USERID IS NOT AUTHORIZED TO IPL SYSTEM name 
Your userid is not authorized to IPL system name. 


CP ENTERED; DISABLED WAIT PSW psw 
CP entered; disabled wait PSW psw 
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VM/XA SF Conversion 


Table 28 (Page 11 of 17). VM/XA SF and VM/XA SP Incompatible Messages _ 


No. 
0452 


0475 


0521 


0541 


0542 


0575 


0580 


0581 


0582 


0584 


0585 


0586 


05387 


0588 


0589 


System 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


Text 


CP ENTERED; EXTERNAL INTERRUPT LOOP 
CP entered; external interrupt loop 


FATAL I/O ERROR READING DIRECTORY ENTRY [FOR USER userid] 
Fatal I/O error trying to read directory from volid [for user userid] — 


type rdev HAS NO AVAILABLE CHANNEL PATHS 
type rdev has no available channel paths 


COPY ERROR ON PRINTER 
The PF key copy function cannot complete due to a permanent I/O error on the 
printer. 


DASD rdev OP INC CMD =cm SNS= sense IRB= irb USERID = userid BBC 
DASD rdev OP INC CMD =cm SNS = sense IRB = irb USERID = userid 
[BBCCHH = bbcchh] 


1/0 ERROR ADD = raddr, USERID = userid 
I/O error add rdey, userid = userid 


RECORDING RETRIEVAL DISK nn% FULL, USER userid 
TAPE rdev A SENSE COMMAND WAS ISSUED WITH NO OUTSTANDING 
UNIT CHECK 


RECORDING RETRIEVAL DISK FULL, USER userid] 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A LOAD 
DISPLAY CHECK OCCURRED LOAD DISPLAY CHECK OCCURRED 


RECORDING recording name nnn PURGED; USER userid 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A WRITE ID 
MARK CHECK OCCURRED 


RECORDING COUNT ann RECORDS recording name userid 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A 
CAPABILITY CHECK OCCURRED 


RECORDING ERROR function re RECORDS recording name userid 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A TAPE VOID 
CHECK OCCURRED 


RECORDING ERROR function error code userid 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE OF A LOSS OF 
TENSION ON THE TAPE 


RECORDING IDENTIFY ERROR userid {INVALID|PROTOCOL} 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A TAPE 
LENGTH ERROR OCCURRED 


RECORDING ENTRY recording name userid NOT ALTERED 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE THE 
PHYSICAL END OF TAPE WAS ENCOUNTERED 


RECORDING DATA RETRIEVAL STARTED, RECORDS recording name 
userid | 

TAPE rdev AN OPERATION WAS TERMINATED BECAUSE THE 
BEGINNING OF THE TAPE WAS ENCOUNTERED 
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No. 
0591 


0592 


0593 


0594 


0595 


0596 


0597 


0598 


0632 


0633 


0634 


0635 


0636 


System 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF Conversion 


Table 28 (Page 12 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


Text 


nnnn recording name RECORDS PROCESSED, USER userid 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE DESIRED 
BLOCK WAS NOT FOUND 


ENTER END OR SUMMARY 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE THE DRIVE IS 
ASSIGNED ELSEWHERE 


RECORDING ERROR re ON function USER userid 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE THE DRIVE IS 
OFFLINE 


RECORDING RETRIEVAL, RECORD recording name nnnn TOO LARGE, 
USER userid 
TAPE rdev A CONTROL UNIT CHECK ONE ERROR OCCURRED 


RECORDING RETRIEVAL recording name WRITE ERROR rc[,USER userid] 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A CONTROL 
UNIT ERP FAILURE OCCURRED 


INVALID INPUT PARAMETER option 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE THE 
CONTROL UNIT AND DRIVE ARE INCOMPATIBLE 


RECORDING INITIALIZATION ERROR, RECORDS NOT RETRIEVABLE 
TAPE rdev AN OPERATION WAS TERMINATED BECAUSE A READ 
OPPOSITE CHECK OCCURRED 


RECORDING ENTRY NOT FOUND 
TAPE rdey AN OPERATION WAS TERMINATED BECAUSE OF AN 
INVALID BLOCK ID SEQUENCE 


TOD CLOCK SYNCRONIZATION FAILURE 
The TOD-clock could not be synchronized due to a processor controller failure. 


PROCESSOR NN - TOD CLOCK SYNCHRONIZATON FAILURE 
The TOD-clock could not be synchronized because CP was unable to vary a 
processor back online. 


PROCESSOR CONTROLLER FAILURE; ORDERLY SYSTEM SHUTDOWN 
IS RECOMMENDED 
A system shutdown is recommended due to a processor controller failure. 


COMMAND REJECTED; VECTOR nn ALREADY ONLINE 
The VARY ONLINE VECTOR command cannot be processed because vector nn 
is already online. 


COMMAND REJECTED; VECTOR nn ALREADY OFFLINE 
The VARY OFFLINE VECTOR command cannot be processed because vector nn 
is already offline. 


VECTOR mn LOGICALLY OFFLINE; PHYSICAL VARY FAILED 
Vector facility nn is logically offline but the physical vary failed. 


VARY VECTOR COMMAND FAILED; PROCESSOR nn NOT ONLINE 
The VARY VECTOR command cannot be processed because processor nn is not 
online. 


Chapter 20. VM/XA SF and VM/XA SP Compatibility Tables 229 


VM/XA SF Conversion 


Table 28 (Page 13 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


No. 


0637 


0638 


0649 


0650 


0657 


0659 


0660 


0661 


0662 


0663 


0664 


0743 


0745 


0746 


0749 


0750 


0751 


System 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 
VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


Text 


VARY VECTOR COMMAND FAILED; VECTOR nn NOT AVAILABLE 
The VARY VECTOR command cannot be processed because vector facility nn is 
not available. 


LAST OPERATIONAL VECTOR FACILITY HAS BEEN REMOVED FROM 
CONFIGURATION 
The last operational vector facility has been removed from the configuration. 


VECTOR nn NO LONGER AVAILABLE TO SERVICE DEDICATED USER 
vruser CPU nn 

Vector facility nn is no longer available to service the dedicated user userid on 
CPU nn. 


CP ENTERED; COMPLEX INTERRUPT LOOP 
The virtual machine is placed in CP mode due to a complex interrupt loop. 


PAGE ZERO DAMAGED 
The virtual machine's page zero is unavailable because it is damaged. 


VECTOR NOT DEFINED; VECTOR nn ALREADY EXISTS 
The vector cannot be defined because vector nn already exists. 


VECTOR nn DOES NOT EXIST 
The DETACH command cannot be processed because vector nn does not exist. 


VECTOR NOT DEFINED; CPU nan DOES NOT EXIST 
The vector cannot be defined because CPU nn does not exist. 


NO REAL VECTOR FACILITY AVAILABLE TO SERVICE VECTOR nn 
[nn...| 
No real vector facility is available to service vector(s) nn {nn...}. 


VECTOR NOT DEFINED; NO REAL VECTOR FACILITY INSTALLED 
The vector cannot be defined because no real vector facility is installed. 


NO REAL VECTOR FACILITY AVAILABLE TO SERVICE 
NON-DEDICATED USERS 
No real vector facility is available to service non-dedicated users. 


VECTOR FACILITY NOT AVAILABLE 
DIAL function not available 


VECTOR REGISTER CONTENTS HAVE BEEN LOST FOR CPU nn 
The vector register contents have been lost for CPU nn. 


SPOOL FILE ERROR WHILE PROCESSING VECTOR REGISTERS _ 
A spool file error occurred while processing the vector registers. 


STORE EXCEEDS MAXIMUM ELEMENT 
Store exceeds maximum element 


OPERAND EXCEEDS ALLOWED MAXIMUM LENGTH FOLLOWING 
USER userid 

RESTRICTED PASSWORD FILE{, ERROR DURING READ| HAS BAD 
RECORD FORMAT] HAS BAD RECORD LENGTH} 


INVALID OPERAND - operand FOLLOWING USER userid 


INVALID OPERAND - operand [FOLLOWING PROFILE profname|USER 


userid] 
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VM/XA SF Conversion 


Table 28 (Page 14 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


No. 
0752 


0765 


0770 


0782 


0785 


0799 


0811 


0820 


0830 


0831 


0832 


0833 


0834 


0835 


0836 


System 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SE 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 
VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 
VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


Text 


STATEMENT SEQUENCE ERROR FOLLOWING USER userid 
STATEMENT SEQUENCE ERROR [FOLLOWING {PROFILE 
profname|USER profname|userid] 


LOGICAL RECORD LENGTH OR RECORD FORMAT IS INCORRECT 
INVALID CLASS DEFINITION - class 


DUPLICATE USERID userid FOUND 
Override invalid for command 


1/O ERROR VIRTUAL DEVICE IS BUSY 
ERROR ATTEMPTING TO RETURN FREE STORAGE 


INVALID ELEMENT element 
Invalid element - element 


IPL FAILED DUE TO INSUFFICIENT OR FAULTY STORAGE 
IPL failed due to insufficient or faulty storage 


PREFERRED VIRTUAL MACHINE RECOVERY SUPPRESSED - 
RESERVED PAGE FRAMES EXHAUSTED. 

Preferred virtual machine recovery is suppressed because the supply of reserved 
page frames is exhausted. 


IUCV FUNCTION IS NO LONGER ACTIVE FOR USER userid 
The IUCV function is no longer active for user userid because preferred virtual 
machine recovery is in process. 


PROCESSOR CONTROLLER IS RESPONDING SLOWLY 
The processor controller is responding slowly. 


PROCESSOR CONTROLLER IS NOW RESPONDING 
The processor controller is now responding. 


PROCESSOR CONTROLLER IS LOGICALLY DISCONNECTED FROM 
THE SYSTEM DUE TO AN INCONGRUOUS RESPONSE 
The processor controller is disconnected due to a system error. 


IOCP WRITE SEQUENCE STARTED, WILL ALTER I/O CONFIGURATION 
DATA SET xx 

An IOCP has started a write sequence that will alter the I/O configuration data set 
XX: 


IOCP WRITE SEQUENCE TERMINATED, I/O CONFIGURATION DATA 
SET xx IS INVALID 

The IOCP write processing cannot complete because the I/O configuration data set 
xx is invalid. 


IOCP WRITE SEQUENCE COMPLETED, I/O CONFIGURATION DATA 
SET xx IS INVALID 

The IOCP write processing has completed; the I/O configuration data set xx is 
altered. 


IOCP WRITE REQUEST REJECTED, LOCKED BY userid 
The IOCP write request cannot complete because userid already has a sequence in 
progress. 
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VM/XA SF Conversion 


Table 28 (Page 15 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


No. 
0837 
0838 


0839 
0840 


0841 


0842 


0843 


0844 
0845 
0846 
0863 
0880 
0881 
0882 
0883 


0884 


System 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 


VM/XA SP 
VM/XA SF 


VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


Text 


IOCP READ REQUEST REJECTED, LOCKED BY userid 
The IOCP read request cannot complete because userid already has a sequence in 
progress. 


PROCESSOR CONTROLLER FAILURE; REQUEST PROCE 
The request process cannot complete due to a processor controller failure. 


IOCP READ OPEN REQUEST REJECTED, TRYING TO OPEN DIFFERENT 
DATA SET, OPENED DATA SET IS xx 
The IOCP read open request cannot complete because data set xx is already open. 


IOCP WRITE OPEN REQUEST REJECTED, TRYING TO OPEN 
DIFFERENT DATA SET, OPENED DATA SET IS xx 
The IOCP write open request cannot complete because data set xx is already open. 


NO SCP INFORMATION, PROCESSOR CONTROLLER REQUEST 
PROCESS IS SUSPENDED 

The processor controller request process cannot complete due to no SCP 
information. 


IOCP READ REQUEST REJECTED, TRYING TO READ FROM 
UNOPENED DATA SET, CURRENT OPEN DATA SET IS xx 

The IOCP read request cannot complete because the data set is not open. The 
current open data set is xx. 


IOCP WRITE REQUEST REJECTED, TRYING TO WRITE TO UNOPENED 
DATA SET, CURRENT OPEN DATA SET IS xx | 

The IOCP write request cannot complete because the data set is not open. The 
current open data set is xx. 


DEVICE NOT DEFINED; INVALID CONTROL UNIT TYPE 
The device is not defined due to an invalid control unit type. — 


DASD rdey NOT ATTACHED; PAGING ADDRESSES OFFLINE 
DASD rdey not attached; paging addresses offline 


INVALID CHPID yy 
Invalid channel path identifier. 


UNABLE TO SUPPRESS USER PAGES; ALL PAGES WILL BE PRINTED 
Invalid parameter - parameter 


COMMAND REJECTED; PROCESSOR nn ALREADY ONLINE 
The command processing cannot complete because processor nn 1s already online. 


COMMAND REJECTED; PROCESSOR mn ALREADY OFFLINE 
The command processing cannot complete because processor nn 1s already offline. 


VARY PROCESSOR COMMAND FAILED, INITIALIZATION FAILURE 
The VARY command processing cannot complete due to an initialization failure. 


COMMAND REJECTED; PROCESSOR nn NOT RESPONSIVE 
The command processing cannot complete because processor nn is not responsive. 


COMMAND REJECTED; PROCESSOR nan IS THE ONLY ACTIVE 
PROCESSOR 

The command processing cannot complete because processor nn 1s the only active 
processor. 
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VM/XA SF Conversion 


Table 28 (Page 16 of 17). VM/XA SF and VM/XA SP Incompatible Messages 


No. 
0885 


0886 


0890 
0891 
0892 
0893 
0894 
0895 


0896 


0897 
0898 
0902 
0904 
0912 


0934 


0953 
0955 


0983 


System 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 


VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


VM/XA SF 
VM/XA SP 


Text 


PROCESSOR nn LOGICALLY OFFLINE, PHYSICAL VARY FAILED 
The VARY processing cannot complete because the physical vary failed; processor 
nn is logically offline. 


VARY PROCESSOR COMMAND FAILED, PROCESSOR nm NOT 
AVAILABLE 

The VARY command processing cannot complete because processor nn is not 
available. 


USER userid VIRTUAL CPU cpuaddr IS ALREADY DEDICATED 
User userid’s virtual CPU nn is already dedicated. 


USER userid VIRTUAL CPU cpuaddr IS NOT DEDICATED 
User userid’s virtual CPU nn is not dedicated. 


NO PROCESSOR AVAILABLE TO DEDICATE 
There is no processor available to dedicate. 


NO V=R USER CURRENTLY LOGGED ON 
There is no Virtual = Real user currently logged on. 


NUMBER OF CPUS DEDICATED IS n 
The number of newly dedicated processors is n. 


NUMBER OF CPUS ALREADY DEDICATED IS n 
The number of previously dedicated processors is n. 


NUMBER OF CPUS NOT DEDICATED IS n; NO PROCESSORS 
AVAILABLE FOR DEDICATION 

The number of processors that could not be dedicated is n, because no processors 
were available. 


NUMBER OF CPUS UNDEDICATED IS n 
The number of newly undedicated processors is n. 


NUMBER OF CPUS NOT DEDICATED IS n 
The number of processors currently not dedicated is n. 


SYSTEM RECOVERY FAILURE; FATAL I/O ERROR 
System recovery failure; fatal 1/O error 


SYSTEM RECOVERY FAILURE; INVALID WARM START DATA 
System recovery failure; invalid warm start data 


SYSTEM RECOVERY FAILURE; VOLID volid NOT MOUNTED 
System recovery failure; volid volid not mounted 


type CYLINDERS IGNORED ON SYSTEM VOLUME volid 
Cylinders allocated as {DRCT (Directory)| SPOL (Spooling)|TDSK (TDisk)} are 
ignored on system volume volid 


UNABLE TO ALLOCATE SYSTEM DASD DUMP 
CP is unable to allocate system DASD dump space. 


INSUFFICIENT STORAGE FOR VM/XA SYSTEMS FACILITY 
INSUFFICIENT STORAGE FOR {VM/XA SP|IPLING SYSTEM} 


SYSTEM RECOVERY FAILURE; SPOOL FILE ERROR 
System recovery failed due to a spool file error. 
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VM/XA SF Conversion 


Table 28 (Page 17 of 17). VM/XA SF and VM/XA SP Incompatible Messages 
No. System Text 


0984 VM/XASF TOD CLOCK DAMAGED. ENABLE CLOCK SET SWITCH 
VM/XA SP TOD clock damaged. Enable clock set switch 


Message Texts That Have Changed Message Numbers 
Some message texts that are the same in VM/XA SF and VM/XA SP have different 
message numbers. In the table below, the VM/XA SF message numbers and their 
corresponding VM/XA SP message numbers are paired. For convenience, the 
system names are abbreviated as “SF” and “SP.” 


SF SP SF SP SF SP SF SP 

014 1550 169 1600 274 1004 356 1604 

017 6000 181 1025 275 1558 357 1605 Pan 
027 1001 182 1026 276 1032 358 1606 a. 
030 1551 183 1027 281 1005 359 1607 _ 
032 1552 184 1028 288 1505 360 6276 

034 6025 185 1029 292 1503 361 1250 

037 1553 186 1030 294 6085 363 6277 

039 6026 187 1031 296 2611 364 1010 

048 1450 195 0039 298 1037 366 6278 

065 6050 196 2003 301 1357 367 6279 

066 6051 197 2004 302 1350 372 6280 | er 
069 1451 198 2005 303 1351 373 6281 a J 
070 9000 199 2006 304 1352 374 6282 a 
071 9001 206 1556 311 6001 375 6283 

075 1452 220 0206 316 6203 376 6284 

079 2000 225 6076 317 6002 377 6285 

080 2001 235 6077 318 6003 378 «6286 

084 1201 236 6078 320 9002 379 6287 

085 1202 237 6079 321 9003 383 0733 

087 1012 238 6080 322 9004 422 1354 of 
089 1013 239 6075 323 9005 425 2505 2 
097 1700 242 2500 324 1033 430 2504 | 

100 1011 243 2501 325 1034 438 1559 

119 6052 244 2502 326 1400 441 1353 

129 1100 245 2503 327 1401 | 443 1355 

135 2002 | 246 0270 328 1402 444 1356 

149 1555 256 1557 330 1453 45] 1459 

151 1150 257 2200 331 1454 456 1455 

152 1151 | 258 2201 332 1456 457 0580 

153 1152 259 2202 334 1458 458 0583 

154 1101 268 1002 341 9501 459 0582 

156 1102 269 1500 343 ~=—sss« 1006 460 0584 

157 1103 270 1501 350 9010 461 0585 

158 1104 372 1003 354 1602 462 0586 

159 1200 273 1502 355 1603 463 0587 
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VM/XA SF Conversion 


SF SP SF SP SF SP SF SP 
( 464 0588 560 8053 654 2628 802 9402 
= 465 0574 561 8054 655 2629 803 9403 
466 0591 570 0589 656 2630 804 9404 
467 0592 574 1105 658 0453 805 9405 
468 0593 577 2218 665 8002 806 9406 
469 0594 578 2219 666 8003 807 9407 
470 0595 579 2220 667 8004 808 9408 
471 0596 580 8056 668 8005 809 9409 
472 0597 581 8057 669 8006 810 9410 
473 0598 582 8058 670 8007 812 9412 
480 6300 583 8059 671 8008 815 9415 
431 6301 584 8060 672 8009 818 9417 
482 6302 585 8061 673 8010 822 9418 
483 6303 586 8062 674 8011 826 9413 
( 484 6304 587 8073 675 8012 827 9414 
485 6305 588 8063 676 8013 85] 8150 
486 6306 589 8064 677 8014 854 8156 
487 6307 590 8065 678 8015 855 8157 
488 6308 591 8066 679 8016 856 8158 
489 6309 $92 8067 680 8017 857 8159 
490 6310 593 8068 68 | 8018 858 8160 
491 6311 594 8069 682 8019 859 8161 
492 6312 595 8070 683 8020 860 8162 
— 493 6313 597 8071 684 8021 861 8163 
( . 494 6314 598 8072 685 8022 862 8164 
495 6315 605 9100 686 8023 863 8151 
Sil 2254 609 9111 687 8024 865 8166 
555 2203 611 9101 688 8025 866 8167 
534 2204 612 9102 689 8026 867 8168 
535 2205 613 9103 690 8027 868 8169 
536 2206 614 9104 691 8028 870 8170 
; 538 2207 615 9105 692 8029 871 817] 
( 539 2208 616 9106 693 8030 872 8172 
540 2209 617 9107 694 803] 873 8173 
546 2150 | 618 9108 695 8032 874 8174 
550 8000 619 9109 696 8033 901 9015 
551 8001 620 9110 697 8034 903 9016 
552 8050 621 9150 698 8035 905 9017 
553 0863 622 9151 699 8036 906 9018 
554 8074 623 9152 706 0756 907 9019 
555 8075 624 9153 707 9014 910 9250 
556 8076 625 9154 730 8100 911 8200 
557 8077 651 2625 7710 0772 913 8201 
558 8051 652 2626 800 9400 914 9251 
559 8052 653 2627 801 9401 915 9020 
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VM/XA SF Conversion 


SF 


916 
917 
918 
919 
920 


921 


» 922 


924 
925 
926 


927 
928 
929 
930 
932 


933 


934 
935 
936 
937 


938 
939 
940 
941 
942 


943 
950 
956 
962 
963 
964 
966 
975 
976 
977 


978 
979 
987 
989 
990 


997 
998 
999 


SP 


9021 
9022 
2600 
9225 
9275 


9276 
9023 
9300 
2210 
2211 


0576 
2213 
2214 
2215 
6200 


6201 
6202 
0319 
0320 
0321 


0322 
0323 
0324 
0325 
326 


0332 
a2oe 
2601 
9024 
O27) 


9025 


9026 
9200 
9201 
9202 


9203 
9204 
9252 
8202 
9253 


8203 
8204 
8205 
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VM/XA SP Release 1 to Release 2 Migration 


Part 3. Migrating from VM/XA SP Release 1 to Release 2 


Part 3. Migrating from VM/XA SP Release 1 to Release 2 237 


| 


hiDamSanad islon ted Mote Aaseateinss $eot ina dacetetees Hoa EDN Ate CLE oe ee OPC 


VM/XA SP Release 1 to Release 2 Migration 


Chapter 21. Migrating from VM/XA SP Release 1 to Release 2 


In general, VM/XA SP Release 2 is upwardly compatible with VM/XA SP Release 1, 
with the exception of the AUTOLOG command, the user directory, and messages 
(which have changed significantly). 


AUTOLOG Command Compatibility 


In VM/XA SP Release 1, the AUTOLOG command and the XAUTOLOG 
command are synonymous. In VM/XA SP Release 2, the AUTOLOG command has 
fewer functions than in Release | (and is compatible with VM/SP HPO), and the 
XAUTOLOG command provides the functions of the Release 1 AUTOLOG 
command. A summary of differences follows: 


Release 1 AUTOLOG and Release 2 


XAUTOLOG Release 2 AUTOLOG 

The privilege class is A, B, or G. The privilege class is A or B. 

The command has keyword The command does not have keyword 
parameters. parameters. 


The command does not require use of The command requires use of a 
a password. password, either on the command or 
in response to a prompt. 


The logical-line-end symbol (#) The logical-line-end symbol (#) does 
precedes console-input-data. not precede console-input-data. 


The user ID being logged on need not The user ID being logged on must 
have a corresponding IPL statement in have a corresponding IPL statement 


the system directory. in the system directory. 
The command runs synchronously or The command runs synchronously. 
asynchronously. 


The command 1s not compatible with The command is compatible with 


VM/SP HPO. VM/SP HPO. 


Directory Compatibility 
The Release 1 and Release 2 user directories are incompatible. Differences are: 
e The MINIOPT statement. 


A new parameter in Release 2, MDC/NOMDC, specifies whether a minidisk is 
to use the Expanded Storage cache. The default is to use the cache. However, 
to guarantee data integrity, minidisk caching should be disabled for any minidisk 
that is shared between two systems when one or both systems have write access 
to the minidisk. To disable caching for an individual minidisk, specify NOMDC 
on its MINIOPT statement. An alternative is to disable caching for all 
minidisks by issuing the RETAIN XSTORE MDC OFF command. (If you use 
this command you should place it in the AUTOLOGI PROFILE.) 


The change to MINIOPT does not have to be reversed when backing off to 
Release 1. 
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VM/XA.SP Release 1 to Release 2 Migration 


| | e The CONSOLE statement. 


| Device types 1052 and 3210 are not valid in Release 2: device types 3215 and 
| 3270 still are. If you specify an invalid device type and you use the MIXED 
| 
| 


operand of the DIRECTXA command, Release 2 accepts the CONSOLE 
statement and assigns a valid device type. | 


| | e The INCLUDE statement, a new statement. 


| This statement specifies the name of a PROFILE entry to be invoked as part of 
Lt this USER entry. Do not use it until you have completed migration to Release 
| 2 and will not be backing off. 3 


| ¢ The PROFILE statement, a new statement. 


| This statement defines the start of a profile entry in the source directory. Do 
| not use it until you have completed migration to Release 2 and will not be 
| backing off. 


| e The END parameter, a new parameter of the MDISK statement. 


| This parameter specifies that the MDISK should be defined with the remaining \ 
| available cylinders. Do not use it until you have completed migration to Release 
| 2 and will not be backing off. 


Scenarios for Migrating from VM/XA SP Release 1 to Release 2 


| 

| The following scenarios are examples of how a Release 2 system might be brought 

| into production and later backed off if system problems occur. The scenarios take 

| into account the incompatibilities in the Release 1 and Release 2 user directories. ao 

| The scenarios are: ( ; 
7 eZ 


| e Migrating to VM/XA SP Release 2 with one source and one object directory 
| ° Backing off from VM/XA SP Release 2 with one source and one object directory 
| | ¢ Migrating to VM/XA SP Release 2 with one source and two object directories 


| | ¢ Backing off from VM/XA SP Release 2 with one source and two object 
| | directories. 


| The scenarios assume that the DIRECTXA MODULE exists on the system’s source ‘a | 
| directory disk (the disk that contains the USER DIRECT file). es 


| Migrating to VM/XA SP Release 2 with One Source and One Object Directory 
| 1. Record DASD allocations in a log so that the information is available to 

| operations personnel who might have to bring up or back off the Release 2 

| system. This information should have restricted access due to the sensitivity of 

| the data contained on these devices. The DASD allocations you should record 

| are the volume serial numbers, starting cylinder locations, and number of extents 
| for: | 


| a ¢ The source user directory 
| | ¢ The object user directory 
| © CMS minidisks (usually 190 and 19E). 


| 2. Make a copy of the Release 2 DIRECTXA MODULE available on your source 
| directory disk by copying the Release 2 DIRECTXA MODULE as DIRECTXA 
| 
| 


SP2MOD. It is assumed that the Release | DIRECT MODULE already exists 
on the same disk. 


240 VM/XA System Product Conversion Notebook 


Oo CO 4 NHN 


10. 


11. 


12. 


13. 


14. 


ae EAR Ss cc Ye nha ieets Huds peten ted blab na, heisaeve amebiasis mitiely nana Die ee tk Bela cil alas vaatne cla date Tee alee Ea Seale ee 


VM/XA SP Release 1 to Release 2 Migration 


. Bring up your Release 2 system without a directory. To do this, respond with 


NODIRECT when CP issues the START prompt. 


. Because the system directory is invalid, do not allow any service machines to be 


autologged. Force the logoff of your installation’s AUTOLOGI, DISKACNT, 
and EREP user IDs. 


. Define the source and object user directories as well as the CMS minidisks (190 


and 19E) to the operator’s logon ID. Use the DEF MDISK command and the 
previously logged device and allocation information. 


. Define 16Mb of storage. (Enter DEF STOR 16M.) 

. IPL a nonshared copy of CMS. (Enter IPL 190 and TERM MODE VM.) 
. Access the source directory disk (ACCESS command). | | 

. Swap the Release 1 and Release 2 DIRECTXA MODULE files. That is, 


rename DIRECTXA MODULE as DIRECTXA SPIMOD and DIRECTXA 
SP2MOD as DIRECTXA MODULE. 


Modify the directory for Release 2. Using XEDIT with file serialization set off 
(SET SERIAL OFF), modify the source user directory (USER DIRECT) to 
reflect the needs of your installation and the incompatibilities with Release 1. 
(Refer to “Directory Compatibility” on page 239.) 


Create a Release 2 object directory and bring it online. Do this by issuing the 
DIRECTXA command twice to overlay both the primary and alternate object 
directories with a Release 2 object directory. 


Reinitialize the operator’s logon ID by logging off and then logging on with that 
ID. 


Use the XAUTOLOG command to log on your installation’s AUTOLOGI, 
DISKACNT, and EREP user IDs automatically. 


Bring your Release 2 system into production. 


Backing Off from VM/XA SP Release 2 with One Source and One Object 


Directory 


I. 


Locate the DASD allocations you recorded (the volume serial numbers, starting 
cylinder locations, and number of extents) for: 


e The source user directory 
e The object user directory 
¢ CMS minidisks (usually 190 & 19E). 


. Bring up your Release 1 system without a directory. To do this, respond with 


NODIRECT when CP issues the START prompt. 


. Because the system directory is invalid, do not allow any service machines to be 


autologged. Force the logoff of your installation’s AUTOLOGI, DISKACNT, 
and EREP user IDs. 


. Define the source and object user directories as well as the CMS minidisks (190 


and 19E) to the operator’s logon ID. Use the DEF MDISK command and the 
previously logged device and allocation information. 


. Define 16Mb of storage. (Enter DEF STOR 16M.) 
. IPL a nonshared copy of CMS. (Enter IPL 190 and TERM MODE VM.) 
. Access the source directory disk (ACCESS command). 
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10. 


11. 


12. 


. Swap the Release | and Release 2 DIRECTXA MODULE files. That is, 


rename DIRECTXA MODULE as DIRECTXA SP2MOD and DIRECTXA 
SP1MOD as DIRECTXA MODULE. 


. Create a Release 1 object directory and bring it online. Do this by issuing the 


DIRECTXA command twice to overlay both the primary and alternate object 
directories with a valid Release 1 object directory. 


Reinitialize the operator’s logon ID by logging off and then logging on with that 
ID. | 


Use the XAUTOLOG command to log on your installation’s AUTOLOGI, 
DISKACNT, and EREP user [Ds automatically. 


Bring your Release | system into production. 


Migrating to VM/XA SP Release 2 with One Source and Two Object 


Directories 


LE 


10. 


Select a volume to be used ‘sé your Release 2 object directory. This should 


preferably be a volume dedicated for this purpose. 


. Use the CPFMTXA command to allocate the Release 2 object directory volume 


with a sufficient DRCT area. Refer to VM/XA SP Planning and Administration 
for directory size calculations. 


. Add the Release 2 object directory volume to your directory management ID 


(usually DIRMAINT) at a different address from your Release 1 object 
directory. 


. Access the source directory disk (ACCESS command). 
. Make a copy of the Release 2 DIRECTXA MODULE available on your source 


directory disk by copying the Release 2 DIRECTXA MODULE as DIRECTXA 
SP2MOD. 


. Swap the Release 1 and Release 2 DIRECTXA MODULE files. That is, 


rename DIRECTXA MODULE as DIRECTXA SPIMOD and DIRECTXA 
SP2MOD as DIRECTXA MODULE. 


. Using XEDIT with file serialization set off (SET SERIAL OFF), modify the 


source user directory (USER DIRECT) for Release 2 to reflect the needs of your 
installation. Be sure to keep a copy of the current directory “header” line for 
return to Release 1. You can do this by duplicating the DIRECTORY 
statement, commenting out one occurrence, and changing the device 
identification (VDEV DEVTYPE VOLSER) on the other occurrence to identify 
the volume and address that will contain the Release 2 object directory. 


Obtain write access to the Release 2 object directory disk. To do this, ensure 
that the user ID that will issue the DIRECTXA command has either linked to 
the Release 2 object directory disk as the address specified in the DIRECTORY 
statement or has that volume attached to its virtual machine as this address. 


. Create Release 2 object directories by issuing the DIRECTXA command twice 


to overlay both the primary and alternate object directories on the Release 2 
object directory volume with a valid Release 2 object directory. 


Shut down your Release | system. 


If your Release 1 object directory is on a volume used only as a directory 
residence volume, then shut down your Release 1 system. Make sure that this 
volume is physically disabled before you IPL your Release 2 system. 
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If your Release 1 object directory is on your system residence volume or on 
another volume that must be online for Release 2 production or testing, you 
must remove the DRCT allocation from this volume. Reallocate the volume 
using the ALLOCATE option of the CPFMTXA command and log the existing 
allocations for return to Release 1. Reallocate the areas that are DRCT to be 
PERM and shut down your Release | system. 


11. IPL your Release 2 System. 


Backing Off from VM/XA SP Release 2 with One Source and Two Object 


Directories | 
1. Locate the log that you created from your migration to Release 2. 


2. Restore the Release 1 object directory volume. 


If your Release 1 object directory was on a volume used only as a directory 
residence volume, you restore it by reenabling that device and attaching it to the 
ID that will perform the DIRECTXA. It should be attached as the address that 
was formerly in the directory “header” statement. This information can be 
retrieved from the log entry that you created when you migrated to Release 2. 


If your Release 1 object directory was on your system residence volume or on 
another volume that was online for Release 2 production or testing, you must 
now restore the DRCT allocation on this volume. Reallocate the volume using 
the CPFMTXA command, restoring the original disk allocations to those from 
your log. 


. Access the source directory disk (with the ACCESS command). 
. Swap the Release 1 and Release 2 DIRECTXA MODULE files. That 1s, 


rename DIRECTXA MODULE as DIRECTXA SP2MOD and DIRECTXA 
SPIMOD as DIRECTXA MODULE. 


. Using XEDIT with file serialization set off (SET SERIAL OFF), modify .the 


source user directory (USER DIRECT) for Release 1 to reflect the needs of your 
installation. Be sure to restore the Release 1 DIRECTORY statement by 
“uncommenting” it and commenting out the Release 2 version. 


. Obtain write access to the Release 1 object directory disk. To do this, ensure 


that the user ID that will issue the DIRECTXA command has either linked to 
the Release 2 object directory disk as the address specified in the DIRECTORY 
statement or has that volume attached to its virtual machine as this address. 


. Create a Release 1 object directory by issuing the DIRECTXA command twice 


to overlay both the primary and alternate object directories on the Release 1 
directory volume with a valid Release i object directory. 


. Shut down your Release 2 system. 


If your Release 2 object directory is on a volume used only as a directory 
residence volume, then shut down your Release 2 system. Make sure that this 
volume is physically disabled before you IPL your Release | system. 


If your Release 2 object directory is on a volume that must be online for Release 
| production, you must remove the DRCT allocation from this volume. 
Reallocate the volume using the ALLOCATE option of the CPFMTXA 
command and restore your Release 1 allocation on this volume. This 
information can be retrieved from the log that you created during your 
conversion to Release 2. 


9. IPL your Release 1 system. 
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Spool File Compatibility 


Because the spool file formats are compatible between VM/XA SP Release 1 and 
Release 2, you do not need to cold start when migrating or backing off. 


Message Compatibility 


Table 29 compares VM/XA SP Release 1 and VM/XA SP Release 2 messages. 
Messages listed are: | 


e Sometimes-compatible messages. The message number exists in both systems, 


and Release 2 contains both a compatible and an incompatible message text. 
The particular situation determines which text is used. | 


Incompatible messages. The message number exists in both systems but 
differences between message texts may cause applications that depend on 
message texts to execute incorrectly or not to execute at all. 


Release-l-only messages. 


Messages not listed are: 


¢ Compatible messages. The message number exists in both systems and has the 


same message text. 


Release-2-only messages. 


Table 29 (Page 1 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
0001 


0002 


0003 


0004 


0005 


0006 


0007 


0008 


0009 


Code 
IC 


IC .- 


SC 


IC 


IC 


SC - 


IC 


IC 


IC 


System 


Release | 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Text 


UNKNOWN CP COMMAND: command 
Unknown CP command: command 


INVALID OPERAND - operand 
Invalid operand - operand 


INVALID OPTION - option 
[Invalid option - option] or [INVALID OPTION - option] 


INVALID HEXLOC - hexloc 
Invalid hexloc - hexloc 


INVALID HEXDATA - hexdata 
Invalid hexdata - hexdata 


INVALID DEVICE TYPE - {rdev|vdev|ldev} 
[Invalid device type - {rdev|vdev|ldev}] or [INVALID DEVICE TYPE - 
{rdey|vdev|ldev} | 


INVALID USERID - userid 
Invalid userid - userid 


INVALID SPOOLID - spoolid 
Invalid spoolid - spoolid 


INVALID RANGE - range 
Invalid range - range 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 2 of 30). VM/XA SP Release | and VM/XA SP Release 2 Message Compatibility 


No. 
0010 


0011 


0012 


0013 


0018 


0019 


0020 


0021 


0022 


0023 


0024 


0025 


0026 


0028 


0030 


0031 


0033 


0035 


Code 
IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


SC 


SC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 


Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Text 


INVALID REGISTER - register 
Invalid register - register 


INVALID DEVICE TYPE - userid vdev 
Invalid device type - userid vdev 


INVALID PSW - psw 
Invalid PSW - psw 


CONFLICTING OPTION - option 
Conflicting option - option 

SPOOLID MISSING 

Spoolid missing 

COMMAND PROCESSOR NOT LOADED 


The system command processor 1s not loaded. 


USERID MISSING OR INVALID 
Userid missing or invalid 


RDEV MISSING OR INVALID 
A real device number was not supplied or it is invalid. 


VDEV MISSING OR INVALID 

[A virtual device number was not supplied or it was invalid.] or [A 
VIRTUAL DEVICE NUMBER WAS NOT SUPPLIED OR IT WAS 
INVALID.] 


VOLID MISSING OR INVALID 
[VOLID missing or invalid] or [VOLID MISSING OR INVALID] 


CYLINDERS MISSING OR INVALID | 
[Cylinders missing or invalid] or [CYLINDERS MISSING OR INVALID] 


STORAGE MISSING OR INVALID 
Storage missing or invalid 


OPERAND MISSING OR INVALID 
Operand missing or invalid 


CLASS MISSING OR INVALID 
Class missing or invalid 


COPIES MISSING OR INVALID 
Copies missing or invalid 


BUFFER MISSING OR INVALID: EXTENDED FCB NOT 
SUPPORTED 
Buffer missing or invalid; extended FCB not supported 


HEXLOC MISSING OR INVALID 
Hexloc missing or invalid 


DEVICE TYPE MISSING OR INVALID 
Device type missing or invalid 


SC = sometimes compatible, IC = incompatible, 1C = Release | only. 
Not listed: compatible messages and Release-2-only messages. 


Chapter 21. Migrating from VM/XA SP Release 1 to Release2 245 


few esc Sogo as wi iia ol aateneu Witenes. tue wu Geass pee eel 


VM/XA SP Release 1 to Release 2 Migration 


Table 29 (Page 3 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
0036 


INDEX MISSING OR INVALID 


0038 


_ 0039 


0040 


0041 
0042 
0043 
0044 
0045 
0046 
0047 
0049 
0050 


0052 


0053 


0054 


0055 


0056 


Code 


IC 


IC 


IC 


SC 


Ic 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC. 


System 


Release 1 
Release 2 


Release | 


Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1] 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Text 


Index missing or invalid 


PARAMETER FOR option OPTION MISSING OR INVALID - 
parameter 


Parameter for option option missing or invalid - parameter 


PROCESSOR ADDRESS MISSING OR INVALID 
Processor address missing or invalid 


DEVICE {rdev|vdev\ldev} DOES NOT EXIST 
[Device {rdev|vdev|ldev} does not exist] or [DEVICE {rdev|vdev|ldev} DOES 
NOT EXIST] 


LOGMSG nn DOES NOT EXIST 
Logmsg nn does not exist. 


USER userid SPOOLID nnnn DOES NOT EXIST 
User userid spoolid nnnn does not exist 


BUFFER name DOES NOT EXIST 
Buffer buffer does not exist 


SYSTEM name DOES NOT EXIST 
System {name|volume} does not exist 


userid NOT LOGGED ON 
userid not logged on 


type rdev OFFLINE 
type rdev offline 


userid vdev DOES NOT EXIST 
userid vdev does not exist 


type rdev IN USE 
type vdev in use 


-PASSWORD INCORRECT 


LOGON unsuccessful--incorrect password 


ERROR IN CP DIRECTORY 
[Error in CP directory] or [KAUTOLOG failed for userid: Error in CP 
directory] | 


userid NOT IN CP DIRECTORY 
[userid not in CP directory] or [XAUTOLOG failed for userid: userid not in 
CP directory] 


ALREADY LOGGED ON {GRAF|rdev|GRAFidev|DISC} 
[XAUTOLOG failed for userid:| Already logged on {display 
device|disconnected} 


LINE(S) NOT AVAILABLE ON userid 
Line(s) not available on userid 


LINE vdev BUSY ON userid 
Line vdev busy on userid 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 4 of 30). VM/XA SP Release | and VM/XA SP Release 2 Message Compatibility 


No. 
0057 


0058 


0059 


0060 
0061 
0068 
0088 


0090 


0091 


0093 
0094 


0095 


0101 
0102 


0103 


0104 


0105 


Code 
IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Release | 


Release | 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Text 


userid NOT RECEIVING; text 
userid not receiving; text 


CTCA yvdev BUSY ON userid 
CTCA vdev busy on userid 


AUTOLOG FAILED FOR userid 
{XAUTOLOG|AUTOLOG} failed for userid - {IPL missing|IPL 
failed|accounting errors|incorrect password} 


DUMP FAILED; VIRTUAL PRINTER UNAVAILABLE 
{Dump failed|Printer output terminated}; virtual printer unavailable 


DUMP FAILED; VIRTUAL PRINTER ERROR 
Dump failed; virtual printer error 


SEND COMMAND FAILED, text 
SEND command failed; text 


INVALID COUNT FOR option - operand 
An invalid number was supplied for {COPY|FLASH} - operand. 


DEVICE vdevy NOT DEFINED; DEVICE {rdev|volser} NOT 
AVAILABLE 
Device vdev not defined; {rdev|volser} not available 


DASD vdevy NOT DEFINED; TEMP SPACE NOT AVAILABLE 
DASD vdev not defined; temp space not available 


DEVICE vdevy NOT DEFINED; ERROR IN CP DIRECTORY 


STORAGE EXCEEDS ALLOWED MAXIMUM OF nnn MEG 
Storage exceeds allowed maximum of nnn MEG 


DEVICE vdev NOT DEFINED; MAXIMUM NUMBER OF DEVICES 
ALREADY DEFINED 

Device vdev is not defined because the maximum number of devices is 
already defined. 


DASD vdey FORCED R/O; R/O BY {nnnnnUSERSluserid} 
DASD vdev forced R/O; R/O by {nnnn users|userid} 


DASD vdevy FORCED R/O; R/W BY {nunnnnUSERS|userid} 
DASD vdeyv forced R/O; R/W by {nnnnn users|userid} 


DASD vdey FORCED R/O; R/W BY {nnnnnUSERS|userid}; R/O BY 
{nnnnn USERS|userid} 

DASD vdev forced R/O; R/W by {nnnnn users|userid}; R/O by {nnnnn 
users|userid} 


userid vdev NOT LINKED; R/O BY {nnnnnUSERS|userid} 
userid vdev not linked; R/O by {nnnnn users|userid} 


userid vdev NOT LINKED; R/W BY {nnnnnUSERS|userid} 
userid vdev not linked; R/W by {nnnnn users|userid} 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 5 of 30). VM/XA SP Release | and VM/XA SP Release 2 Message Compatibility 
No. Code System Text 


0106 IC Release 1 userid vdev NOT LINKED; R/W BY {nnnnnUSERS|userid}; R/O BY 
{nnnnn USERS|userid} | 
Release 2. userid vdev not linked; R/W by {unnnn users|userid}, R/O by {nnnnn 
users|userid} | 


0107 IC Release 1 = userid vdev NOT LINKED; NOT IN CP DIRECTORY 
Release 2. userid vdev not linked; not in CP directory 


0108 IC Release | userid vdev NOT LINKED; VOLID volid NOT MOUNTED 
Release 2 userid vdev not linked; volid volid not mounted 


0109 IC Release 1 userid vdev NOT LINKED; INVALID LINK DEVICE 
Release 2. userid vdev not linked; invalid link device 


0110 IC Release 1 userid vdev NOT LINKED; type vdev ALREADY DEFINED 
Release 2. _—userid vdev not linked; type vdev already defined Pa 


0111 IC Release 1 userid vdev NOT LINKED; NO READ PASSWORD Ne 
Release 2. _—_—usserid vdev not linked; no read password 


0112 IC Release 1 userid vdev NOT LINKED; NO WRITE PASSWORD 
Release 2. userid vdev not linked; no write password 


0113. IC Release | userid vdev NOT LINKED; NO MULTIPLE PASSWORD 
Release 2. —_ userid vdev not linked; no multiple password 


0114 IC Release 1 userid vdev NOT LINKED; MODE OR PASSWORD INCORRECT 


Release 2. —_ userid vdev not linked; mode or password incorrect co 
0115 IC Release 1 {AUTOLOG/LINK} INVALID; EXCESSIVE INCORRECT ey 
PASSWORDS 


Release 2 {LINK|AUTOLOG|XAUTOLOG} invalid; excessive incorrect passwords 


0117. IC Release 1 USERID userid NOT LINKED; VOLID volid CONFLICT 
Release 2. Userid userid not linked; volid volid conflict 


0118 IC Release 1 userid vdev NOT LINKED; COMMAND FORMAT NOT VALID 
Release 2 userid vdev not linked; command format not valid 


0120 IC Release 1 type{rdev|ldev} NOT ATTACHED: userid vdey ALREADY DEFINED ie * 
Release 2. _— type {rdev\|ldev} not attached; userid vdev already defined ed 


0121 IC Release 1 type {rdev\ldev} NOT ATTACHED TO userid 
Release 2. _—_— type {rdev|ldev} not attached to {userid|system} 


0122 IC Release 1 type {rdev\ldev} ALREADY ATTACHED TO userid 
Release 2. type {rdev\ldev} already attached to userid 


0123 IC Release 1 DASD rdey CP-OWNED 
Release 2 DASD rdev CP-owned 


0124 IC Release 1 DASD rdev IN USE BY nannn USERS 
Release 2. DASD rdev in use by nnnnn users 


0125 IC Release 1 DASD rdev VOLID volid ALREADY ATTACHED TO SYSTEM 
Release 2. DASD rdev volid volid already attached to system 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 6 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
0126 


0127 
0128 
0140 
0141 
0142 
0143 
0146 
0148 
0150 
0153 


0155 


0160 
0163 
0164 
0167 
0170 


0174 


Code 
IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release ] 
Release 2 


Release | 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Text 


DASD rdev ERROR READING VOLID 
DASD rdey error reading volid 


DASD rdev VOLID volid DOES NOT MATCH 
DASD rdev volid volid does not match 


DASD rdev ERROR READING ALLOCATION RECORD 
DASD rdeyv error reading allocation record 


type{rdev|ldev' ATTACHED TO userid 
type {rdev|ldev } attached to userid 


type rdev NOT ACTIVE 
type rdev not active 


type rdev NOT DRAINED 
type rdev not drained 


type rdev IN USE BY SYSTEM 
type rdev in use by system 


VMDUMP FAILED; SPOOLING ERROR 
VMDUMP failed; spooling error 


PRT rdev BUFFER LOAD name FAILED 
Printer rdev buffer load name failed 


USER userid HAS ISSUED A {CP/VM} READ 
User userid has issued a {CP|VM} read 


DEV {vdev|RNG} NOT ATTACHED, EXCEEDS MAX NUM DEVICES 
Device {vdev, RANGE} exceeds maximum number of virtual devices 


DEVICE rdev HAS NOT BEEN ATTACHED TO THE SYSTEM 
BECAUSE IT IS NOT A DASD DEVICE 

Device rdev has not been attached to the system because it is not a DASD 
device. 


HEXLOC hexloc EXCEEDS STORAGE 
Hexloc hexloc exceeds storage 


STORE EXCEEDS MAXIMUM REGISTER 
STORE exceeds maximum register 


HEXLOC hexloc NON-ADDRESSABLE STORAGE 
Hexloc hexloc non-addressable storage 


INVALID MASK FOR DATA RANGE SPECIFIED 
The mask is invalid for the specified data range. 


SYSTEM name EXCEEDS STORAGE SIZE; {nnnK/nnnM} REQUIRED 
System name exceeds storage size; {nnnnnnnnK|nnnM} required 


PAGING I/O ERROR; IPL FAILED 
Paging I/O error; IPL failed 


SC = sometimes compatible, IC = incompatible, 10 = Release | only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 7 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
0177 


0180 
0196 
0197 


0200 


0202 
0203 
0204 
0205 
0206 
0232 


0240 


0259 


0260 


Code 
IC 


IC 
IC 
IC 


IC 


IC 
IC 
IC 
IC 
IC 
IC 


IC 
IC 


IC 


IC 


IC 


System 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release ] 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Text 


YOUR PARM DATA EXCEEDS THE LIMIT OF mn CHARACTERS. 


CORRECT YOUR DATA STRING AND REISSUE THE IPL 
COMMAND. | 
Your PARM data exceeds the limit of nn characters. Correct your data 
string and reissue the IPL command. 


TRACE NOT IN EFFECT 
Trace not in effect 


SECONDARY USER NOT IN CP DIRECTORY 
Secondary user not in CP directory 


SECONDARY USER IS NOT AVAILABLE 
Secondary user is not available 


VIRT = REAL AREA NOT AVAILABLE; IN USE BY {userid|nnnn 
user(s)} 
Virtual = Real area not available; in use by {userid|nnnn user(s)} 


VIRT= REAL AREA NOT AVAILABLE; INSUFFICIENT STORAGE 


Virtual = {Real|Fixed} area not available; insufficient storage 


V=R AREA REQUIRES IPL BY DEVICE NUMBER 
Virtual = {Real|Fixed} area requires IPL by device number 


_ INVALID PAGE(S) SPECIFIED, V=R AREA 


Invalid page(s) specified - Virtual = Real area 


VIRT = REAL AREA NOT GENERATED 
The virtual =real area is not available because it was not generated. 


CANNOT CONNECT TO HOST VIRTUAL MACHINE 
Cannot connect to host virtual machine 


IPL UNIT ERROR, {CSW =csw|IRB = irb}, SENSE = sense 
IPL UNIT ERROR, {CSW = csw|IRB = irb}, SNS= sense 


PRT rdev FCB feb DOES NOT MATCH FORM LENGTH 
The form length mounted on printer rdev does not match the length 
described by the FCB fcb. 


PRT rdev UNDEFINED LOAD IMAGE imagname SPECIFIED 
An undefined load image imagename was specified for printer rdey. 


PRT rdev, PAGE BUFFER DESTROYED, BACKUP PAGE COUNT = 


nnnn 
PRINTER rdev; PAGE BUFFER DESTROYED, BACKUP PAGE 
COUNT = annn 


SIZE PARAMETERS MISSING OR INVALID 
SIZE parameter missing or invalid 


COMMAND |command| ENDED DUE TO ERRORS 
{Command|SPTAPE command|command command} processing cannot 
complete due to errors. 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 8 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
0261 


0262 


0263 


0264 


0266 


0267 


0270 


0295 


0298 


0299 


0300 


0310 


0315 


0319 


0326 


0332 


Code 
IC 


IC 


Ic 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release J 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Text 


INVALID KEY - key 
key is an invalid storage key. 


VIRTUAL CONSOLE NOT DEFINED 
The virtual console is not defined or is detached. 


TOO MANY OPERANDS IN COMMAND LINE 
[Too many operands were supplied for this command.| or [TOO MANY 
OPERANDS WERE SUPPLIED FOR THIS COMMAND.] 


OPTION(S) IGNORED; option(s) 
One or more options are ignored during reconnect processing - option(s) 


ACCOUNT NUMBER MISSING OR INVALID 
An account number was not supplied or is invalid. 


SCHIB MISSING OR INVALID 
A subchannel number was not supplied or is invalid. 


PRT rdev TOO MANY WCGMS NEEDED FOR “CHARS” 
The character sets specified for the printer rdev required more writable 
character generation modules than were available. 


INVALID PAGE(S) SPECIFIED, NOT CP PAGEABLE AREA 
The specified pages cannot be locked or unlocked because they are not in 
the CP pageable area. 


userid vdev NOT LINKED; REQUEST DENIED 
userid vdev not linked; request denied 


name NOT DEFINED; SKELETON ALREADY EXISTS. 
The {Named Saved System (NSS)|saved segment} name could not be 
defined because a class S file with the same name already exists. 


SAVE REQUEST BEYOND VIRTUAL MACHINE SIZE 
Save request beyond virtual machine size 


DATE date INVALID; NOT CHANGED 
Date date invalid; not changed 


INVALID MODE - MUST BE 370 
THE CPFORMAT COMMAND REQUIRES THE VIRTUAL 
MACHINE TO BE IN 370 MODE. 


ERROR PROCESSING SUBSYSTEM COMMAND cmd FOR DASD 
rdey 
Error processing subsystem command - cmd for DASD rdev 


DASD rdev TRACK FORMAT NOT SUPPORTED FOR PAGING - 
SS-XX-KX 

DASD rdevy TRACK FORMAT NOT SUPPORTED FOR PAGING - 
SS-XX-XX PAGING -b-XX-XX 


INVALID CONTROL UNIT TYPE - rdev 
Invalid control unit type - rdev 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 9 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
0339 


0351 
0353 
0361 


0362 


0386 
0387 


0388 


0389 


0396 
0400 
0401 
0405 


0406 


0407 


SC = sometimes compatible, IC = 


Code 
IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


- Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Text 


INVALID PAGE DESCRIPTOR CODE invalid-code FOR RANGE 
nnnnn-nnnnn; SEGMENT ZERO MUST BE EXCLUSIVE. 

The command processing cannot complete because the page descriptor code 
invalid-code for the page range nnnnn-nnnnn should be exclusive. 


DASD rdev NOT READY - SYSRES VOLUME 
DASD rdev SYSRES NOT READY 


SYSRES DEVICE TYPE INVALID OR DEVICE rdev NOT 
OPERATIONAL 
Sysres device type invalid or device rdev not operational 


LOGOFF/FORCE PENDING FOR THIS USER userid 
{XAUTOLOG failed for userid:} LOGOFF/FORCE pending for user 


userid 


DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE THE 
SUBCHANNEL-ID IS INVALID. 

[Device rdev cannot be varied online because the subchannel-id is invalid.] 
or [DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE THE 
SUBCHANNEL-ID IS INVALID.] 


DASD vdev IS READ ONLY | 
FORMATTING CANNOT BE DONE ON DASD vdev BECAUSE IT IS 
READ-ONLY. 


INVALID CONSOLE vdev FOR CP FORMAT 
THE CPFORMAT COMMAND REQUIRES A 3-DIGIT DEVICE 
NUMBER FOR THE VIRTUAL CONSOLE vdev. 


CP FORMAT CANNOT BE ISSUED BY A {V=R/|V=F} USER 
CPFORMAT cannot be issued by a Virtual = {Real|Fixed} user. 


CYLINDER RANGE TOO LARGE - DEVICE vdev HAS nann 
CYLINDERS 

THE CYLINDER RANGE IS TOO LARGE BECAUSE DEVICE vdev 
HAS nnnn CYLINDERS. 


{CPFORMAT|CPFMTXA} TERMINATED 
THE CPFORMAT COMMAND PROCESSING DID NOT COMPLETE. 


SYSTEM {SPOOLING|PAGING} AREA FULL 

All {paging|spooling} space is in use. 

SYSTEM {SPOOLING|PAGING} AREA 90 PERCENT F ULL 
90 percent of all {paging|spooling} space is in use. 


MOUNT FORM operform ON {PRT|PUN}rdev 
Mount form operform on {printer|punch} rdev 


SETUP FORM operform ON PRT rdev FOR FORMS ALIGNMENT 
CHECK | | 
Check forms alignment for form operform on printer rdev. 


NO FILES FOR SPTAPE ON DRIVE rdev 
No files were {scanned|dumped|loaded} for SPTAPE on drive rdev. 


incompatible, 10 = Release 1 only. 


Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 10 of 30). VM/XA SP Release | and VM/XA SP Release 2 Message Compatibility 


No. 
0408 


0409 
0412 


0413 


0415 


0416 


0417 


0418 


0419 


0421 


0422 


0423 


0427 


0428 


0429 


0431 


0432 


0433 


Code 
IC 


1O 
IC 


IC 


IC 


IC 
Ic 
IC 
IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release | 
Release 2 


Release 1 


Release | 
Release 2 


Release | 
Release 2 


Release | 


Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release | 
Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Text 


INPUT TAPE ON DRIVE rdev IS NOT IN SPTAPE FORMAT 
The input tape on drive rdev is not in SPTAPE format. 


SPTAPE OUTPUT TAPE CAPACITY EXCEEDED ON DRIVE rdev 


SPTAPE UNRECOVERABLE I/O ERROR ON DRIVE rdev 
An unrecoverable I/O error occurred on the SPTAPE tape drive rdey. 


COMMAND ENDED DUE TO SPOOL PAGING ERROR 
Command processing cannot complete due to a spool paging error. 


CONTINUOUS PAGING ERRORS FROM DASD annn VOLUME 
volser 
Six continuous paging errors have occurred on DASD nnnn volume volser. 


SPTAPE func FUNCTION ON DRIVE rdev TERMINATED 
The SPTAPE func function on drive rdev did not complete. 


{rdev|vdev} NOT AN OUTPUT SPOOLING DEVICE 
{rdev/vdev} is not an output spooling device. 


{rdev|\vdev} NOT A SPOOLED DEVICE 
{rdev/vdey} is not a spooled device. 


{rdev|\vdev} NOT A SPOOLED PRINTER 
{rdev/vdev} is not a spooled printer. 


PRT prt-type DOES NOT SUPPORT feature|command 
Printer prt-type does not support the {feature feature|command command}. 


CONFLICTING OPTION; SAME OPTION SPECIFIED TWICE 
The same option was specified twice. 


CONFLICTING OPTION; INCOMPATIBLE WITH PRIOR OPERAND 
The function requested is incompatible with a previously specified operand. 


type {rdev|vdev|name} SYSTEM SPOOL SPACE FULL; FILE 
{HELD|PURGED} 
type {rdev\|vdev|name} system spool space full; file {closed|held|purged} 


{PRT|PUN|RDR|TAPE} rdev SPOOL ERROR; FILE {HELD|PURGED} 
type rdev spool error; file {held|purged|closed} 


{CONS|PRT|PUN|RDR} vdev SPOOL ERROR; FILE 
{HELD|PURGED} 
type vdev spool error; file {held|purged} 


RDR rdevy ID CARD MISSING OR INVALID 
Reader rdev id card missing or invalid 


RDR rdev ID CARD INVALID; userid NOT IN CP DIRECTORY 
The ID card for reader rdey 1s invalid because userid is not in the CP 
directory. 


RDR rdev ID CARD; INVALID DATA - data 


Reader rdev id card; invalid data - data 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 11 of 30). VM/XA SP Release | and VM/XA SP Release 2 Message Compatibility 


No. 
0435 


0439 


0440 


0445 


0446 


0447 


0448 


0449 


0450 


0452 


0453 


0475 


0521 


0541 


SC = 


Code 
IC 


IC 


IC 


Ic 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


SC 


IC 


System 


- Release 1 


Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


sometimes compatible, IC = 


Text 


PAGING I/O ERROR OCCURRED WHILE WRITING A PAGE. 
ee napa e ey nes COMMAND NOT 
COMPLETED. 

{SAVESYS|SAVESEG} command was not completed because a paging I/O 
error occurred while writing a page. 


USER userid SPOOL FILEID LIMIT EXCEEDED 
{User userid|*NSS|*IMG|*UCR|*NLS} spool fileid limit exceeded 


{SYSTEM|SEGMENT} name {DEFINED|SAVED} SUCCESSFULLY 
IN FILEIDfileld. 

{Named Saved System (NSS)|saved segment} name was successfully 
{saved|defined} in fileid fileid 


{SEGMENT|SYSTEM} name COULD NOT BE {DEFINED|SAVED} 
DUE TO AN UNEXPECTED ERROR. 

The {Named Saved System (NSS)|saved segment} name could not be 
{saved|defined} due to an unexpected error. 


{SEGMENT|SYSTEM} name NOT PREVIOUSLY DEFINED AND 
CANNOT BE SAVED. 

The {Named Saved System (NSS)|saved segment} name was not previously 
defined and cannot be saved. 


SYSTEM sysname CANNOT BE IPLED DUE TO INVALID 
PROCESSOR CONFIGURATION 
System sysname cannot be IPLed due to an invalid processor configuration. 


SYSTEM name NOT QUIESCED. OUTSTANDING {I/O ON DEVICE | 


vdev|EXTERNAL INTERRUPT} 
System name not quiesced. Outstanding {I/O on device vdeviexternal 
interrupt} 


YOUR USERID IS NOT AUTHORIZED TO IPL SYSTEM name 
Your userid is not authorized to IPL system name. 


CP ENTERED; DISABLED WAIT PSW psw 
CP entered; disabled wait PSW psw 


CP ENTERED; EXTERNAL INTERRUPT LOOP 
CP entered; external interrupt loop 


CP ENTERED; PROGRAM INTERRUPT LOOP 
CP entered; program interrupt loop 


FATAL I/O ERROR TRYING TO READ DIRECTORY FROM volid 
[FOR USER userid] 
Fatal I/O error trying to read directory from volid [for user userid] 


type rdev HAS NO AVAILABLE CHANNEL PATHS 
[type rdev has no available channel paths] or [type rdev HAS NO 
AVAILABLE CHANNEL PATHS] | 


COPY ERROR ON PRINTER 
The PF key copy function cannot complete due to a Peevesnen I/O error 
on the printer. 


incompatible, 1O = Release 1 only. 


Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 12 of 30). VM/XA SP Release | and VM/XA SP Release 2 Message Compatibility 


No. 
0542 


0575 


0630 


0631 


0632 


0633 


0634 


0635 


0636 


0637 


0638 


0645 


0649 


0650 


Code 
IC 


IC 


IC 


IC 


Ic 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release | 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 


Release 2 


Release | 


~ Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


~ Release 1 


Release 2 


Text 


DASD rdev OP INC CMD=cm SNS= sense IRB =irb USERID = userid 
[BBCCHH = bbcchh] 
DASD rdev OP INC CMD=cm SNS= sense IRB=irb USERID = userid 
[BBCCHH = bbcchh| 


I/O ERROR ADD= raddr, USERID = userid 
I/O error add rdev, userid= userid 


TOD CLOCK SYNCRONIZATION FAILURE 
The TOD-clock could not be synchronized due to a processor controller 
failure. 


PROCESSOR nn - TOD CLOCK SYNCHRONIZATON FAILURE 
The TOD-clock could not be synchronized because CP was unable to vary 
a processor back online. 


PROCESSOR CONTROLLER FAILURE; ORDERLY SYSTEM 
SHUTDOWN IS RECOMMENDED 
A system shutdown is recommended due to a processor controller failure. 


COMMAND REJECTED; VECTOR nn ALREADY ONLINE 
The VARY ONLINE VECTOR command cannot be processed because 
vector mn is already online. 


COMMAND REJECTED; VECTOR mn ALREADY OFFLINE 
The VARY OFFLINE VECTOR command cannot be processed because 
vector mn is already offline. 


VECTOR nn LOGICALLY OFFLINE; PHYSICAL VARY FAILED 
Vector facility nn is logically offline but the physical vary failed. 


VARY VECTOR COMMAND FAILED; PROCESSOR nn NOT 
ONLINE 

The VARY VECTOR command cannot be processed because processor nn 
is not online. : 


VARY VECTOR COMMAND FAILED; VECTOR nn NOT 
AVAILABLE 

The VARY VECTOR command cannot be processed because vector 
facility mn is not available. 


LAST OPERATIONAL VECTOR FACILITY HAS BEEN REMOVED 
FROM CONFIGURATION 

The last operational vector facility has been removed from the 
configuration. 


VECTOR FACILITY NOT AVAILABLE 
Vector facility not available 


VECTOR nn NO LONGER AVAILABLE TO SERVICE DEDICATED 
USER vruser CPU nn 

Vector facility nn is no longer available to service the dedicated user userid 
on CPU naz. 


CP ENTERED; COMPLEX INTERRUPT LOOP 
The virtual machine is placed in CP mode due to a complex interrupt loop. 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 13 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
0657 


0659 


0660 


0661 


0662 


0663 


0664 


0743 


0745 


0746 


0749 


0752 


0770 


0785 


0795 


0798 


0799 


Code 
IC 


IC 


IC 


IC 


IC 
IC 
IC 


IC 
IC 
IC 
IC 


IC 


IC 
IC 
10 


IC 


IC 


System 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release | 


Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2? 


Release | 
Release 2 


Release 1 


| Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 


Release | 


Release 2 


Release 1 
Release 2 


Text 


PAGE ZERO DAMAGED 
The virtual machine's page zero is unavailable because it is damaged. 


VECTOR NOT DEFINED; VECTOR nn ALREADY EXISTS 
The vector cannot be defined because vector nn already exists. 


VECTOR mn DOES NOT EXIST 
The DETACH command cannot be processed because vector nn does not 
exist. | 


VECTOR NOT DEFINED; CPU an DOES NOT EXIST 
The vector cannot be defined because CPU nn does not exist. 


NO REAL VECTOR FACILITY AVAILABLE TO SERVICE VECTOR 
nninn...| 
No real vector facility is available to service vector(s) nn {nn...}. 


VECTOR NOT DEFINED; NO REAL VECTOR FACILITY 
INSTALLED 
The vector cannot be defined because no real vector facility is installed. 


NO REAL VECTOR FACILITY AVAILABLE TO SERVICE 
NON-DEDICATED USERS 
No real vector facility is available to service non-dedicated users. 


DIAL FUNCTION NOT AVAILABLE 
DIAL function not available 


VECTOR REGISTER CONTENTS HAVE BEEN LOST FOR CPU nn 
The vector register contents have been lost for CPU nn. 


SPOOL FILE ERROR WHILE PROCESSING VECTOR REGISTERS 
A spool file error occurred while processing the vector registers. 


STORE EXCEEDS MAXIMUM ELEMENT 
Store exceeds maximum element 


STATEMENT SEQUENCE ERROR FOLLOWING USER userid 
STATEMENT SEQUENCE ERRIR [FOLLOWING {PROFILE 
profname| USER userid} | 


OVERRIDE INVALID FOR command 
Override invalid for command 


INVALID ELEMENT - element 
Invalid element - element 


STATEMENT CONFLICTS WITH CLASS VALUE ON USER 
STATEMENT FOLLOWING USER userid 


keyword] KEYWORD CONFLICTS WITH keyword2 FOLLOWING 
USER userid 

keyword] KEYWORD CONFLICTS WITH keyword2 FOLLOWING 
{PROFILE profname|USER userid} 


IPL FAILED DUE TO INSUFFICIENT OR FAULTY STORAGE 
IPL failed due to insufficient or faulty storage 


SC = sometimes compatible, IC = incompatible, 10 = Release | only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 14 of 30). VM/XA SP Release | and VM/XA SP Release 2 Message Compatibility 


No. 
0811 


0820 


0825 


0830 


0831 


0832 


0833 


0834 


0835 


0836 


0837 


0838 


SC = 


Code 
IC 


IC 


SC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release | 


Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 


Release 2 


Release 1 


Release 2 


Release | 


Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


sometimes compatible, IC = incompatible, 10 = 


Text 


PREFERRED VIRTUAL MACHINE RECOVERY SUPPRESSED - 
RESERVED PAGE FRAMES EXHAUSTED. 

Preferred virtual machine recovery is suppressed because the supply of 
reserved page frames is exhausted. 


IUCV FUNCTION IS NO LONGER ACTIVE FOR USER userid DUE > 
TO PREFERRED VIRTUAL MACHINE RECOVERY. 

The IUCV function is no longer active for user userid because preferred 
virtual machine recovery is in process. 


PREFERRED VIRTUAL MACHINE RECOVERY SUPPRESSED. 
REASON: text 

[PREFERRED VIRTUAL MACHINE RECOVERY SUPPRESSED. 
REASON: text] or [Preferred virtual machine recovery suppressed. 
Reason: Expanded storage not recovered. | 


PROCESSOR CONTROLLER IS RESPONDING SLOWLY 
The processor controller is responding slowly. 


PROCESSOR CONTROLLER IS NOW RESPONDING 
The processor controller is now responding. 


PROCESSOR CONTROLLER IS LOGICALLY DISCONNECTED 
FROM THE SYSTEM DUE TO AN INCONGRUOUS RESPONSE 
The processor controller is disconnected due to a system error. 


IOCP WRITE SEQUENCE STARTED, WILL ALTER I/O 
CONFIGURATION DATA SET xx 

An IOCP has started a write sequence that will alter the I/O configuration 
data set xx. 


IOCP WRITE SEQUENCE TERMINATED, I/O CONFIGURATION 
DATA SET xx IS INVALID 

The IOCP write processing cannot complete because the I/O configuration 
data set xx is invalid. | 


IOCP WRITE SEQUENCE COMPLETED, I/O CONFIGURATION 
DATA SET xx HAS BEEN ALTERED 

The IOCP write processing has completed; the I/O Eger no data set 
xx 1s altered. 


IOCP WRITE REQUEST REJECTED, LOCKED BY userid 
The IOCP write request cannot complete because userid already has a 
sequence in progress. 


IOCP READ REQUEST REJECTED, LOCKED BY userid 
The IOCP read request cannot complete because userid already has a 
sequence in progress. 


PROCESSOR ee FAILURE; REQUEST PROCESS IS 
SUSPENDED 
The request process cannot complete due to a processor controller failure. 


Release 1 only. 


Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 15 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
0839 


0840 


0841 


0842 


0843 


0344 


0845 


0846 


0847 


0848 


0849 


0863 


0880 


0881 


Code 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release | 


Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 


Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Text 


IOCP READ OPEN REQUEST REJECTED, TRYING TO OPEN 
DIFFERENT DATA SET, OPENED DATA SET IS xx 

The IOCP read open request cannot complete because data set xx is 
already open. 


IOCP WRITE OPEN REQUEST REJECTED, TRYING TO OPEN 
DIFFERENT DATA SET, OPENED DATA SET IS xx 

The IOCP write open request cannot complete because data set xx is 
already open. 


NO SCP INFORMATION, PROCESSOR CONTROLLER REQUEST 
PROCESS IS SUSPENDED 

The processor controller request process cannot complete due to no SCP 
information. 


IOCP READ REQUEST REJECTED, TRYING TO READ FROM 
UNOPENED DATA SET, CURRENT OPEN DATA SET IS xx 

The IOCP read request cannot complete because the data set is not open. 
The current open data set is xx. 


IOCP WRITE REQUEST REJECTED, TRYING TO WRITE TO 
UNOPENED DATA SET, CURRENT OPEN DATA SET IS xx 

The IOCP write request cannot complete because the data set is not open. 
The current open data set is xx. 


DEVICE NOT DEFINED; INVALID CONTROL UNIT TYPE 
The device is not defined due to an invalid control unit type. 


DASD rdev NOT ATTACHED; PAGING ADDRESSES OFFLINE 
DASD rdev not attached; paging ae aa offline 


INVALID CHPID yy 
yy is an invalid channel path identifier. 


MAXIMUM SYSTEM SPOOL FILE LIMIT EXCEEDED 
Maximum system spool file limit exceeded 


SYSTEM PARAMETER IS INVALID WITH THE SPOOLID OPTION 
SYSTEM parameter is invalid with the spoolid option 


A USERID MUST BE SPECIFIED WITH THE SPOOLID 
A userid must be specified with the spoolid 


INVALID PARAMETER -- parameter 
Invalid parameter - parameter 


COMMAND REJECTED; PROCESSOR nn ALREADY ONLINE 


The command processing cannot complete because processor nn is already 


online. 


COMMAND REJECTED; PROCESSOR nn ALREADY OFFLINE 


The command processing cannot complete because processor nn is already 


offline. 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 16 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
0882 


0883 


0884 


0885 


0886 


0890 


0891 


0892 


0893 


0894 


0895 


0896 


0897 


0898 


0902 


0904 


Code 
IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release | 


Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Text 


VARY PROCESSOR COMMAND FAILED, INITIALIZATION 
FAILURE 

The VARY command processing cannot complete due to an initialization 
failure. 


COMMAND REJECTED; PROCESSOR nn NOT RESPONSIVE . 
The command processing cannot complete because processor mn is not 
responsive. 


COMMAND REJECTED; PROCESSOR nn IS THE ONLY ACTIVE 
PROCESSOR | 

The command processing cannot complete because processor nn is the only 
active processor. 


PROCESSOR nn LOGICALLY OFFLINE, PHYSICAL VARY FAILED 
The VARY processing cannot complete because the physical vary failed; 
processor nn is logically offline. 


VARY PROCESSOR COMMAND FAILED, PROCESSOR nn NOT 
AVAILABLE 

The VARY command processing cannot complete because processor nn is 
not available. 


USER userid VIRTUAL CPU cpuaddr IS ALREADY DEDICATED 
User userid’s virtual CPU nn is already dedicated. 


USER userid VIRTUAL CPU cpuaddr IS NOT DEDICATED 
User userid’s virtual CPU nn is not dedicated. 


NO PROCESSOR AVAILABLE TO DEDICATE 
There is no processor available to dedicate. 


NO V=R USER CURRENTLY LOGGED ON 
There is no Virtual = Real user currently logged on. 


NUMBER OF CPUS DEDICATED IS n 
The number of newly dedicated processors is n. 


NUMBER OF CPUS ALREADY DEDICATED IS n 
The number of previously dedicated processors is 7. 


NUMBER OF CPUS NOT DEDICATED IS n; NO PROCESSORS 
AVAILABLE FOR DEDICATION 

The number of processors that could not be dedicated is n, because no 
processors were available. 


NUMBER OF CPUS UNDEDICATED IS n 
The number of newly undedicated processors is n. 


NUMBER OF CPUS NOT DEDICATED IS a 
The number of processors currently not dedicated is n. 


SYSTEM RECOVERY FAILURE; FATAL I/O ERROR 
System recovery failure; fatal I/O error 


SYSTEM RECOVERY FAILURE; INVALID WARM START DATA 
System recovery failure; invalid warm start data 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 17 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
0912 


0953 


0983 


0984 


1001 


1002 


1003 


1005 


1006 


1008 


1009 


1011 


1012 


1013 


1025 


1026 


1027 


1028 


Code 
IC 


IC | 
IC 
IC 
IC 
IC 
IC 
IC 


IC 


IC 
IC 
IC 
IC 
IC 
IC 
IC 
IC 


IC 


System 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Text 


SYSTEM RECOVERY FAILURE; VOLID volid NOT MOUNTED 
System recovery failure; volid volid not mounted 


UNABLE TO ALLOCATE SYSTEM DASD DUMP — 
CP is unable to allocate system DASD dump space. 


SYSTEM RECOVERY FAILURE; SPOOL FILE ERROR 
System recovery failed due to a spool file error. 


TOD CLOCK DAMAGED. ENABLE CLOCK SET SWITCH 
TOD clock damaged. Enable clock set switch 


MISSING OPERAND FOR option 
An operand is missing for option. 


VOLID volid DOES NOT EXIST 
Volume identifier volid does not exist. 


arg NOT FOUND 
{CP module name|rdev|ldev} {is|\was} not found. 


INVALID CHARACTER 
An invalid character was encountered. 


COMMAND REJECTED; SYSTEM RESOURCES NOT AVAILABLE 
The command processing cannot complete because system resources are not 
available. 


DEVICE rdev IS NOT A DASD 
Device rdev is not a DASD 


DEVICE rdev IS NOT ATTACHED TO THE SYSTEM 
Device rdey is not attached to the system 


HARD ABEND CODE TABLE FULL 
An operand is missing for option. 


QUEUE TYPE MISSING OR INVALID 
Queue type missing or invalid 


INVALID OPERAND FOR option - operand 
An invalid operand was supplied for option - eperand. 


RECURSIVE TRACE CALL REJECTED 
A recursive trace call cannot be done. 


TRACE RETURN REJECTED; NO CALLING TRACE SET 
The trace return cannot be done because there is no matching trace call. 


AN ACTIVE TRACE SET HAS TURNED RUN OFF 
An active trace set has turned RUN off. 


TRACE ENTRY CANCELLED DUE TO PAGING ERROR 
Trace entry cannot complete due to paging error. 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 18 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
1029 


1030 


1031 


1032 


1033 


1034 


1035 


1036 


1037 


1100 


1101 


1102 


1103 


1104 


L105 


Code 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


iC 


SC 


System 


Release 1 


Release 2 


Release | 


Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 


Release 2 


Release 1 


Release 2 


Release | 


Release 2 


Release | 
Release 2 


Text 


CCW TRACING CANCELLED; MAXIMUM BUFFER SIZE HAS 
BEEN EXCEEDED 

CCW tracing cannot complete because the maximum buffer size has been 
exceeded. 


CCW TRACING CANCELLED; SYSTEM VIRTUAL STORAGE 
PAGING ERROR 
CCW tracing cannot complete due to a system virtual storage paging error. 


SET RUN ON IS NOT ALLOWED WHEN TRACE IS ACTIVE 
SET RUN ON is not allowed when the trace function 1s active. 


SYNTAX ERROR 
A syntax error was encountered. 


NO SPECIFIC TRACE IN EFFECT 
No SPECIFIC CP TRACE is in effect. 


NO SPECIFIC TRACE IN EFFECT FOR xxxxxxxx 
No SPECIFIC CP TRACE is in effect for userid. 


TRACE SET CANNOT BE APPENDED TO ITSELF 
A trace set cannot be appended to itself. 


traceset IS AN EMPTY TRACE SET 
{traceset\|The current trace set} 1s an empty trace set. 


TRAP LIMIT EXCEEDED; COMMAND REJECTED 
The command cannot be processed because the maximum number of 
TRACE traps is already defined. 


LDEV MISSING OR INVALID 
A logical device number was not supplied or it is invalid. 


type rdev IS NOT SUPPORTED AS A SYSTEM-OWNED DEVICE 
DASD rdeyv is not supported as a system-owned device. 


type rdev HAS NOT BEEN ATTACHED BECAUSE THE PAGING 
SUBSYSTEM IS ALREADY OWNED BY userid 

DASD rdev has not been attached because the paging subsystem is already 
owned by userid. 


type rdev HAS NOT BEEN ATTACHED BECAUSE A REAL DASD 
PAGING SUBSYSTEM MUST MAP TO ONLY ONE VIRTUAL 
PAGING SUBSYSTEM | 

DASD rdeyv has not been attached because a real DASD subsystem must 
map to only one virtual paging subsystem. 


type rdev HAS NOT BEEN ATTACHED BECAUSE MULTIPLE REAL 
DASD PAGING SUBSYSTEMS MUST NOT MAP TO THE SAME 
VIRTUAL DASD PAGING SUBSYSTEM 

DASD rdev has not been attached because multiple real DASD paging 
subsystems must not map to the same virtual DASD paging subsystem. 


TAPE rdev NOT ATTACHED; TAPE ASSIGNED ELSEWHERE 
[Tape rdev not attached; tape assigned elsewhere.| or [TAPE rdev NOT 
ATTACHED; TAPE ASSIGNED ELSEWHERE] 


SC = sometimes compatible, IC = incompatible, 1O = Release | only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 19 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
1107 


L150 


1151 


1152 


1200 


1201 


1202 


1250 


1280 


1281 


1350 


1352 


1353 


Code 
IC 


IC 


IC 


IC 


IC 


IC 


IC 


SC 


IC 


IC 


IC 


IC 


IC 


System 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release | 


Release 2 


Text 


ATTACH FAILED; 1/O ERROR ON type rdev 
Attach failed; I/O error on tape rdev 


DASD {rdevivdev} IS NOT A VALID BASE EXPOSURE 
DASD {rdeyv|vdey} is not a valid base exposure. 


userid vrdev HAS NOT BEEN LINKED BECAUSE IT IS NOT WITHIN 
CP VOLUME CYLINDER EXTENTS 

userid vdev has not been linked because it is not within CP volume cylinder 
extents. | 


userid vdev HAS NOT BEEN LINKED BECAUSE IT WOULD 
OVERLAP SYSTEM type SPACE 

userid vdev has not been liked because it would overlap 
{directory|spool|page|temporary disk} space 


DASD vdev HAS NOT BEEN REDEFINED BECAUSE PAGING 
SUBSYSTEM DEVICES CANNOT BE REDEFINED 


DASD vdev has not been redefined because paging subsystem device cannot 
be redefined. 


DEVICE vdev ACTIVE, CANNOT BE READIED 
Device vdev cannot be readied because it is active. 


DEVICE vdev ACTIVE, REWIND NOT DONE 
Device vdev was not rewound because it is active. 


DEVICE vdev CANNOT BE VARIED ON-LINE BECAUSE A 
TIME-OUT CONDITION OCCURRED. 

[Device rdev cannot be varied online because a time-out condition 
occurred.] or [DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE 
A TIME-OUT CONDITION OCCURRED.] 


DEVICE vdev NOT USABLE; RESERVE LOST [BY userid AS vdey] 
Device vdev not usable; reserve lost [by userid as vdev] 


PATH xx TO DEVICE rdev NOW OFFLINE; PATH GROUP ID 
MISMATCH 
Path channel to device rdev now offline; path group ID mismatch. 


{SYSTEM|SEGMENT} name CANNOT BE SAVED. {V=R/|V=F|MP} 
USERS CANNOT SAVE AN NSS OR DCSS. 

{Named Saved System (NSS)|The saved segment} name cannot be saved 
because {MP Virtual = Real|Virtual = Fixed} users cannot save a {Named > 
Saved System (NSS)|saved segment}. 


SYSTEM name CANNOT BE PROCESSED. 
System name cannot be processed. 


AN INVALID {NAME name|PAGE RANGE nannn-nnnnn}WAS 
DETECTED IN {DEFSYS|DEFSEG} COMMAND. 

An invalid {name name|page range nnnnn-nnnnn} was detected in the 
{DEFSYS|DEFSEG} command 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 20 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
1354 


1355 


1356 


1357 


1358 


1359 


1400 


1401 


1402 


1450 


1451 


1452 


1453 


1454 


Code 
IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release 1 


Release 2 


Release 1 


Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 


Release 2 


Release | 
Release 2 


Release | 


Release 2 


Release | 


Release 2 


Release 1 


- Release 2 


Release 1 
Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Text 


AN INVALID STORAGE PAGE DESCRIPTOR CODE invalid-code 
WAS DETECTED FOR PAGE RANGE nannan-nnnnn 

An invalid storage page descriptor code invalid-code was detected for page 
range nnnnn-nnnnn. 


SEGMENT NUMBER ann HAS CONFLICTING SHARED AND 
EXCLUSIVE PAGE DESCRIPTOR CODES. 

Segment number nnn was defined with both shared and exclusive page 
descriptor codes. 


CONFLICTING PAGE RANGE annan-nnnnn PLEASE CHECK FOR 
OVERLAPS AND RE-ISSUE THE COMMAND. 

nnnnn-nnnnn is a conflicting page range. Please check for overlaps and 
reissue the command. 7 


370 GUEST CANNOT LOAD A DCSS GREATER THAN 16M. 


370 GUEST CANNOT LOAD A SAVED SEGMENT GREATER THAN 


16M. 


CP DCSS name CANNOT BE LOADED IN NON-SHARED MODE. 
CP saved segment name cannot be loaded in exclusive mode. 


CP|NSS|DCSS| name CANNOT BE SAVED; A CP COPY IS ALREADY 
[ACTIVE|PENDING|PURGE]. 

[CP]{Saved segment|Named Saved Segment (NSS)} name cannot be saved 
because a [CP] copy is already {active|waiting to be purged}. 


XSTORE NOT AVAILABLE. ALREADY IN USE [BY USER-userid] 
Expanded storage is not available because it is already in use. 


XSTORE NOT AVAILABLE WITHIN THIS HARDWARE 
CONFIGURATION 
Expanded storage is not available within this hardware configuration. 


XSTORE IS NOT ATTACHED TO USER userid 
Expanded storage is not attached to user userid. 


STORAGE EXCEEDS SIZE OF V=R AREA WHICH IS nnnn 
MEGABYTES | 

The storage request exceeds the current size available for 

Virtual = {Real|Fixed} user userid, which is nnnnMEG. 


UNABLE TO DUMP PAGE hexloc 
CP is unable to dump page hexloc. 


MORE THAN 8 CPUS IN CONFIGURATION; ADDITIONAL CPU 
DATA NOT DUMPED 

The VMDUMP command is unable to process CPU dump data for more 
than 8 CPU’s. 


CPU NOT DEFINED; CPU nn ALREADY EXISTS 
CPU nn is not defined because it already exists. 


CPU nn DOES NOT EXIST 
CPU nn does not exist. 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 


Not listed: compatible messages and Release-2-only messages. 
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| Table 29 (Page 21 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 
| No. Code System Text 


| 1455 IC Release 1 CPU nn NOT STARTED, CPU IN CHECK- STOP STATE 
| Release 2. CPU nn is not started because it is in check-stop state. 


| 1456 IC Release 1 CPU mn (BASE) IS NOT DETACHED 
| Release 2. The base CPU nn cannot be detached. 


| 1457 IC Release 1 SLEEP COMMAND TERMINATED BY AN ATTENTION AT 

| CONSOLE 

| Release 2. The SLEEP command processing was halted due to an attention interrupt 
| at the console. 


| 1458 IC Release 1 CPU NOT DEFINED; WOULD EXCEED MAXIMUM 
| Release 2. An attempt was made to define more CPU’s than is allowed in your 
| directory. 


| = =©1459 = IC Release 1 CPU mn STOPPED; CHECK-STOP STATE ENTERED 
| Release 2. The virtual machine is placed in check-stop state due to a system ) 
| malfunction with CPU nn. NY 


| 1500 =6IC Release 1 LOGON PROHIBITED, USERID userid INHOLD 
| Release 2 {XAUTOLOG failed for userid:} Logon cannot be done because userid 
| userid is in system hold state. 


| 1501 = =6IC Release 1 ACCOUNTING ERROR 
| Release 2. An accounting error was encountered. 


| 1502. =IC Release 1 USERID DIRECTORY ENTRY IN USE 


| Release2 {XAUTOLOG failed for userid:} The directory entry for this userid is in je 
| use. a 
| 1503) IC Release 1 HOLD QUEUE FULL, HOLD STATUS NOT SET 
| Release 2. Hold status is not set because the hold queue is full. 

1505 IC Release 1 CONSOLE TYPE CONFLICT 


| 
| Release 2. The device being used for LOGON conflicts with the console definition in 
| the directory. : 


| 1506 =6IC Release 1 THE LAST LINE (50) IN THE LOG MESSAGE IS ALREADY IN USE. 
| Release 2. ‘The last line (50) in the log message is already in use. oN 


| 1507 IC Release | DIRECTORY NOT VALID ‘a 
| Release 2. The directory is not valid. 


| 1550 )=6odIC Release 1 INVALID DEVICE CLASS - rdeyv 
| Release 2. _—value is an invalid device class. 


| 1551 IC Release 1 INVALID NUMBER FOR option - operand 
| Release 2. _—- value is an invalid number for MODIFY. 


| 1552. IC Release 1 TOO MANY option OPERANDS SPECIFIED; CANNOT EXCEED n 


| Release 2. More than {4/8} operands were specified for the {CHARS|CLASS} option. 
| 1553. IC Release 1 userid NOT IN HOLD {PRT|PUN|ALL|LOGON} STATUS 


| Release 2. userid 1s not in hold status for {printer|punch|logon|{all devices}. 


| 1554 IC Release 1 BLANK DIRECTORY ENTRY BYPASSED FOR yvdev VM 
Release 2. A blank directory entry has been bypassed for the vdey virtual machine. 


SC = sometimes compatible, IC = incompatible, 10 = Release | only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 22 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
1555 


1556 


1557 


1558 


1559 


1560 


1561 


1600 


1601 


1602 


1700 


1701 


1751 


1752 


1753 


Code 
IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 


Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Text 


SPTAPE DRIVE rdev IN USE BY userid 
userid is already using SPTAPE drive rdev. 


VIRT = REAL AREA NOT AVAILABLE; UNLOCKED 
The Virtual = Real area is not available because it is unlocked. 


SPTAPE NOT ACTIVE ON DRIVE rdev 
SPTAPE is not active on drive rdev. 


COMMAND TERMINATED 
Command processing cannot complete. 


DSNAME TRUNCATED TO 16 CHARACTERS 
The DSNAME is truncated to 16 characters. 


FILE WAS NOT {CHANGED|TRANSFERRED} FILE WAS 
CREATED WITH THE NORETURN OPTION 

File was not {changed|transferred} because it was created with the 
NORETURN option. 


USER userid FILE spoolid 
{HELD|PURGED|FLUSHED|REQUEUED|CLOSED} 
User userid’s file spoolid is {held|purged|flushed|requeued|closed}. 


SPECIFIED CYLINDER NUMBER cylno IS NOT ON THE VIRTUAL 
DISK 
Specified cylinder number cylinder is not on the virtual DASD. 


THE PARM OPTION IS NOT ALLOWED WITH THE SYSTEM 
SPECIFIED ON YOUR IPL COMMAND 

The PARM option is not allowed for the system specified with the IPL 
command. 7 


DASD rdev VOLID NOT volid 
The system nucleus disk label volid does not match the SYSRES device 
volid label. 


VIRTUAL CPU(S) NOT DEFINED; ERROR IN CP DIRECTORY 
One or more virtual CPUs are not defined due to an error in the CP 
directory. 


VIRTUAL VECTOR FACILITY CONTENTS HAVE BEEN LOST 
The virtual vector facility contents have been lost. 


THE DIRECTORY ON VOLUME volser AT ADDRESS rdev HAS 
BEEN BROUGHT ONLINE. 
The directory on volume volume at address rdev has been brought online. 


NO DIRECTORY WAS FOUND; THERE IS NO DIRECTORY 
ONLINE. 
No directory is online because none was found. 


THE DIRECTORY ON VOLUME volser AT ADDRESS rdev IS NOT 
VALID; THERE IS NO DIRECTORY ONLINE. 

There is no directory online because the directory on volume volser at 
address rdey is not valid. 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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| Table 29 (Page 23 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 
| No. Code System Text 


| 2000 IC Release 1 RESERVE NOT RESET ON type rdev. NOT A SHARED DASD 
| Release 2. The reserve was not reset on rdev because it is not a shared DASD. 


| 2001 IC Release 1 RESERVE NOT RESET ON type rdev. DEVICE NOT RESERVED 
| Release 2. The reserve was not reset on DASD rdev because it was not reserved. 


| 2002 + #IC Release 1 RESERVED DEVICE vdev UNCONDITIONALLY RESERVED BY 
| userid vdev 
| Release 2. Reserved device vdev is unconditionally reserved by userid’s vdey. 


| 2003 IC Release 1 SHARED NOT SET {ON|OF} FOR type rdev; NOT A SHARED 
| DEVICE 
| Release 2 Shared not set for type rdev; not a shared device. 


| 2004 IC Release 1 SHARED NOT SET {ON|OFF} FOR type rdey; DOES NOT SUPPORT 
| RESERVE/RELEASE | a 
| Release 2. Shared not set for type rdev; does not support reserve/release. | 


| 2005 IC Release 1 RESERVE PENDING ON rdev FOR USER userid 
| Release 2. Reserve pending on DASD rdev for user userid 


| 2006 §=IC Release 1 SHARED NOT SET {ON|OFF} FOR type rdev; DEVICE NOT ONLINE 
| Release 2 Shared not set for DASD rdeyv; device not online. 


| 2500 §=IC Release 1 IMAGE LIBRARY libname NOT FOUND [FOR PRT rdeyv] 
| Release 2. Image library libname could not be found [for printer rdev]. 


| 2501 IC Release 1 PRT rdev SPOOL PAGING I/O ERROR READING IMAGE pore 
| [LIBRARY] imagname bY 
| Release 2. A spool paging I/O error occurred while reading image [library] imagename 
! | 


7 
on printer rdev | 

| 2502 IC Release 1 PRT rdev LOAD CHECK OCCURRED ON IMAGE imagname; FILE 

| spid {HELD|PURGED|FLUSHED| REQUEUVED/CLOSED} 

| Release 2. Image imagename on printer rdev caused a load check error 

| 2503 IC Release 1 PRT rdev INVALID SEPARATOR {CHAR|FCB} IMAGE SPECIFIED - 

| name 

| Release 2. An invalid separator {FCB|CHAR} image imagename was specified for —_ 

| printer rdev — 


| 2504 IC Release 1 {RDR|PRT|PUN} rdev PERMANENT {LIBRARY|I/O} ERROR; 
| DEVICE {DRAINED|RESET} 
| Release 2 _— type rdev was {drained|reset} due to a permanent {I/Ojlibrary} error. 


| 2505 IC Release 1 INVALID DESTINATION; CANNOT SEND SYSTEM DATA FILE TO 
| AN OUTPUT DEVICE 
| Release 2. An output device is an invalid destination for system data files. 


| 2600 IC Release 1 DASD rdev SUBSYSTEM STORAGE STATUS CANNOT BE 
| DETERMINED 
| Release 2. DASD rdev subsystem storage status cannot be determined. 


| 2601 IC Release 1 THE command COMMAND FAILED BECAUSE DASD rdev IS 
| ELIGIBLE FOR I/O ASSIST 
| Release 2. The command command failed because DASD rdeyv is eligible for I/O assist. 


| SC = sometimes compatible, IC = incompatible, 10 = Release | only. 
| Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 24 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 
2611 


2625 


2626 


2627 


2628 


2629 


2630 


6000 


6003 


6004 


6005 


6025 


6026 


6027 


6050 


Code 
IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Text 


{KEY|DATA} NOT STORED, READ/ONLY PAGE 
{Data|Key} cannot be stored into a read-only page. 


CP ENTERED; SIGP INITIAL PROGRAM RESET FROM CPU nan 
The virtual machine is placed in CP mode due to a SIGP initial program 
reset from CPU nn. 


CP ENTERED; SIGP PROGRAM RESET FROM CPU nn 
The virtual machine is placed in CP mode due to a SIGP program reset 
from CPU nan. 


CP ENTERED; SIGP INITIAL CPU RESET FROM CPU un 
The virtual machine is placed in CP mode due to a SIGP initial CPU reset 
from CPU nn. 


CP ENTERED; SIGP CPU RESET FROM CPU nn 
The virtual machine 1s placed in CP mode due to a SIGP CPU reset from 
CPU nn. 


CP ENTERED; SIGP STOP FROM CPU nn 
The virtual machine is placed in CP mode due. to a SIGP stop from CPU 
nn, 


CP ENTERED; SIGP STOP AND STORE STATUS FROM CPU an 
The virtual machine is placed in CP mode due to a SIGP stop and store 
status from CPU na. 


RANGE CAN NOT EXCEED 256 DEVICES | 
The range of device numbers cannot exceed 256. 


CPFORMAT VIRTUAL CONSOLE NOT DEFINED 
CPFORMAT VIRTUAL CONSOLE IS NOT DEFINED. 


COMMAND command NOT SUPPORTED BY VM/XA SP 
Command command is not supported by VM/XA SP. 


OPTION option NOT SUPPORTED BY VM/XA SP 
Option option is not supported by VM/XA SP. 


OPERAND operand INVALID; CPU nn IN CHECK-STOP STATE 
Operand {STATUS|STORE STATUS|RESTART} is invalid because CPU 
nn is in check-stop state. 


command COMMAND FOR CPU nn INVALID; CPU IN CHECK-STOP 
STATE 

The command command for CPU nn is invalid because the CPU is in 
check-stop state. 


THE PROTECTED APPLICATION ENVIRONMENT IS NOT 
ALLOWED IN VIRTUAL MP MODE THE PROTECTED 
APPLICATION ENVIRONMENT IS {CANCELLED|NOT 
ESTABLISHED} | 

The protected end user environment is not allowed in virtual MP mode. 
The protected end user environment {cancelled|is not established}. 


THIS USERID NOT AUTHORIZED TO AUTOLOG USERID userid 
Your userid is not authorized to automatically logon userid userid 


SC = sometimes compatible, IC = incompatible, 10 = Release | only. 


Not listed: compatible messages and Release-2-only messages. 
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No. 
6051 


6052 


6053 


6054 


6075 


6076 
6077 
6078 
6079 
6080 


6085 
6202 
6203 


6225 


6226 


Code 
IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 
IC 
IC 


IC 


IC 


IC 


IC 


IC 


System 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release | 


Release 2 


Text 


RECONNECT FAILED; RESTART LOGON PROCEDURE 
Restart the logon procedure because reconnect processing cannot be done. 


AUTOLOG COMMAND REJECTED; COMMAND FORMAT NOT 


VALID 
XAUTOLOG command rejected; command format not valid. 


YOU CANNOT {AUTOLOG|LOGON} BECAUSE THE MAXIMUM 


NUMBER OF USERS ALLOWED IS ALREADY LOGGED ON 


XAUTOLOG failed for a: You cannot issue the XAUTOLOG command 


because the maximum number of users allowed is already logged on. — 


AUTOLOG FAILED FOR userid - {IPL MISSING|IPL FAILED} 
ACCOUNTING ERRORS|INCORRECT PASSWORD} 
XAUTOLOG failed for userid: Explanatory message to follow. 


END OF VOLUME segqno ON TRSAVE TAPE rdev 
The end of volume segno has been reached on TRSAVE tape rdey or 
TRSAVE processing has been suspended. 


TRSAVE NOT ACTIVE 
TRSAVE is not active. 


TRSAVE ALREADY ACTIVE 
TRSAVE is already active. 


TRACE TABLE ENTRIES NOT SAVED BY TRSAVE FUNCTION 
The trace table entries were not saved by TRSAVE. 


TAPE DRIVE rdevy DOES NOT SUPPORT MODE {800)1600|6250/38k} 


Tape drive rdev does not support mode mode. 


UNRECOVERABLE I/O ERROR ON DRIVE rdev 
Unrecoverable I/O error has occurred on drive rdev. 


TRSAVE PENDING ACTIVE 


The TRSAVE command cannot be processed because the function is in a 


transition state. 


type CYLINDERS IGNORED ON SYSTEM VOLUME volid 
The {spool|temporary disk|directory} cylinders were ignored on system 
volume volid. 


DEVICE nnnn NOT WITHIN THE 370 ADDRESS RANGE 
THE ADDRESS OF DEVICE nnnn IS BEYOND THE RANGE OF 
VALID 370 DEVICE ADDRESSES. 


IUCV PATH TO *MONITOR IS QUIESCED MONITOR 
{SAMPLE|EVENT} INITIALIZATION RECORDS DELAYED 
Monitor {event|sample} initialization records were delayed because the 
IUCV path to *MONITOR is quiesced. 


MONITOR {EVENT|SAMPLE START FAILED - NO VIRTUAL 
MACHINE CONNECTED TO *MONITOR SYSTEM SERVICE 


Monitor {event|sample} collection cannot start because no virtual machine 


is connected to the *MONITOR system service. 


SC = sometimes compatible, IC = incompatible, 10 = Release | only. 


Not listed: compatible messages and Release-2-only messages. | 
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| Table 29 (Page 26 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


| No. Code System Text 
| 6227 IC Release 1 MONITOR {EVENT|SAMPLE} NOT ACTIVE 
| Release 2 Monitor {event|sample} collection is not active. 
| 6228 IC Release | MONITOR SAMPLE START FAILED-DCSS - dessname 
| COMPLETELY PARTITIONED FOR EVENT DATA 
| Release 2 Monitor sample collection cannot start because DCSS dcssname is 
| completely partitioned for event data. 
| 6229 IC Release 1 MONITOR {EVENT|SAMPLE} ALREADY STARTED 
| Release 2. Monitor {event/sample} collection is already active. 
| 6230 IC Release i MONITOR EVENT START FAILED-BLOCK SIZE IS GREATER 
| THAN HALF THE PARTITION SIZE 
| Release 2 Monitor event collection cannot start because the block size is greater than 
i | half the partition size. 
( | 6231 IC Release 1 MONITOR EVENT START FAILED-PARTITION SIZE IS LARGER 
= THAN DCSS - dessname SIZE 
Release 2 Monitor event collection cannot start: because the partition size is larger 
than DCSS dcessname size. 
| 6232 IC Release | MONITOR {EVENT|SAMPLE} START FAILED - CP PAGING 
| ERROR 
| Release 2 Monitor {event|sample} collection cannot start due to a CP paging error. 
| 6233 IC Release 1 MONITOR EVENT START FAILED-PARTITION SIZE EQUALS THE 
a SIZE OF DCSS - dessname 
( | Release 2. Monitor event collection cannot start because the partition size equals the 
a size of DCSS dcssname. 
6234 IC Release 1 INVALID MONITOR BLOCK VALUE value 
| Release 2 value is an invalid monitor block value. 
| 6235 IC Release | INVALID MONITOR PARTITION VALUE value 
| Release 2. value 1s an invalid monitor partition value. 
6236 IC. Release | INVALID MONITOR INTERVAL VALUE value 
a Release 2 value 1s an invalid monitor interval value. 
( 6237 IC Release 1 EVENT MONITORING WILL NOT BEGIN UNTIL NEXT SAMPLE 
: INTERVAL 
| Release 2. Event monitoring will not begin until the next sample interval. 
| 6238 IC Release 1 INVALID MONITOR RATE VALUE value 
| Release 2. _—i value is an invalid monitor rate value. 
| 6240 IC Release 1 DEVICE dev IS ALREADY ENABLED FOR MONITORING 
| Release 2. Device device is already enabled for monitoring. 
| 6241 IC Release 1 THE NUMBER OF DEVICES SUCCESSFULLY ENABLED FOR 
| MONITORING IS nmunn THE NUMBER OF DEVICES ENABLED BUT 
| OFFLINE IS nnnn 
| Release 2. The number of devices successfully enabled for monitoring is nnn. 
| 6242 IC Release | INVALID DEVICE CLASS OR TYPE FOR SEEKS MONITORING 
: | FOR DEVICE dev 
( ° | Release 2. The class or type of device device is invalid for SEEKS monitoring 
al | SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 


Not listed: compatible messages and Release-2-only messages. 
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No. 
6243 


6244 


6245 


6246 


6247 


6248 


6249 


6276 


6277 


6280 


6281 


Code 
IC 


IC 


IC 


IC 


IC 


IC 


ie 


SC 


SC 


IC 


IC 


System 


Release | 


Release 2 


Release | 


Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release | 


~ Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release ] 


Release 2 


Release | 


Release 2 


Release | 


Release 2 


Text 


NO REPLY FROM userid FOR PREVIOUS MONITOR SAMPLE 
DATA - NEW INTERVAL SKIPPED | | 

The new Monitor sample interval is skipped because userid has not replied 
for the previous interval. 


NO REPLY FROM userid FOR TWO CONSECUTIVE MONITOR 
SAMPLE INTERVALS - SAMPLE MONITORING STOPPED 

No REPLY from userid for two consecutive monitor sample intervals - 
sample monitoring stopped. 


MONITOR IUCV PATH WAS ABNORMALLY SEVERED BY 
USERID userid CODE code 

The monitor IUCV path was abnormally severed by userid userid with 
error code code. 


MONITOR HAS BEEN TERMINATED DUE TO SOFT ABEND 
Monitor has been terminated due to a soft abend. 


MONITOR EVENT PORTION OF DCSS dessname IS FULL, EVENT 
PROCESSING {SUSPENDED|STOPPED} 

Event processing has {suspended|stopped} because the monitor event 
portion of DCSS dcssname 1s full. 


DCSS dessname FOR MONITOR IS NOT LOADED BY THE USER 
CONNECTED TO *MONITOR 
DCSS dcessname is not loaded by the user connected to *MONITOR. 


DEVICE rdev IS ENABLED FOR MONITORING, BUT IS OFFLINE 
Device rdey is enabled for monitoring, but is offline 


DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE THE 
SUBCHANNEL IS NOT OPERATIONAL. 

[Device rdev cannot be varied online because the subchannel is not 
operational.] or DEVICE rdev CANNOT BE VARIED ONLINE 
BECAUSE THE SUBCHANNEL IS NOT OPERATIONAL, ] 


DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE I/O 
ERRORS OCCURRED. 

[Device rdev cannot be varied online because I/O errors occurred.] or 
[DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE I/O 
ERRORS OCCURRED. | | 


DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE A 
DYNAMIC PATHING ERROR OCCURRED. 

Device rdev cannot be varied online because an error occurred while 
attempting to establish a path group. 


DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE OF 
CONFLICTING DEVICE IDENTIFICATION. 

Device rdev cannot be varied online because of conflicting device 
identification information. 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Table 29 (Page 28 of 30). VM/XA SP Release 1 and VM/XA SP Release 2 Message Compatibility 


No. 


6282 


6283 


6284 


6285 


6286 


6287 


8058 


8059 


8060 


8061 


8062 


8063 


8064 


SC = 


Code 


SC 


IC 


IC 


IC 


SC 


SC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release 1 


Release 2 


Release | 


Release 2 


Release | 


Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release | 
Release 2 


Release | 
Release 2? 


Release 1 
Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Text 


DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE THE 


SUBCHANNEL IS INVALID. 

[Device rdev cannot be varied online because the subchannel is invalid.] or 
[DEVICE rdey CANNOT BE VARIED ONLINE BECAUSE THE 
SUBCHANNEL IS INVALID.] 


DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE NO 
CHANNEL PATH IS AVAILABLE 
Device rdev cannot be varied online because no channel path is available. 


DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE OF 
CONFLICTING DEVICE CLASSIFICATION. 

Device rdev cannot be varied online due to conflicting device classification 
information. 


DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE OF 
CONFLICTING DEVICE NUMBERS. 
Device rdey cannot be varied online due to conflicting device numbers. 


DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE THE 
SUBCHANNEL CANNOT BE MODIFIED. 

[Device rdev cannot be varied online because the subchannel cannot be 
modified.] or [DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE 
THE SUBCHANNEL CANNOT BE MODIFIED.] 


DEVICE rdev CANNOT BE VARIED ONLINE BECAUSE IT DID 
NOT RESPOND TO A NO-OP COMMAND. 

[Device rdev cannot be varied online because it did not respond to a no-op 
command.] or [DEVICE rdev CANNOT BE VARIED ONLINE 
BECAUSE IT DID NOT RESPOND TO A NO-OP COMMAND.] 


RECORDING recording-name nnnnn PURGED; USER userid 
User userid has purged count records from recording queue recording-name. 


RECORDING recording-name userid USER NOT RETRIEVING 
CP is recording on queue recording-name but user userid is not actively 
retrieving. 


RECORDING COUNT nannn RECORDS recording-name userid 
User userid should retrieve records from recording-name because the 
recording count count has exceeded a predetermined limit. 


RECORDING ERROR function re RECORDS recording-name_ userid 
Recording error VMCF-function return code records recording-name userid 


RECORDING ERROR funtion error-code userid 
Recording error VMCF function VMCF error flag userid 


RECORDING ENTRY recording-name userid NOT ALTERED 
Recording entry recording-name userid not altered 


RECORDING DATA RETRIEVAL STARTED, RECORDS 
recording-name userid 
Recording data retrieval started, records recording-name userid 


sometimes compatible, IC = incompatible, 10 = Release 1 only. 


Not listed: compatible messages and Release-2-only messages. 
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No. 
8071 


8072 


8073 


9000 


9104 


9105 


9106 


9107 


9109 


9110 


9111 


9150 


9151 


9152 


9153 


Code 


IC 


ite 


IC 


SC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


IC 


System 


~ Release 1 


Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release | 
Release 2 


Release 1 


Release 2 


Release 1 


Release 2 


Release | 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Text 


RECORDING INITIALIZATION ERROR, RECORDS NOT 
RETRIEVABLE 
Recording initialization error, records not retrievable 


RECORDING ENTRY NOT FOUND 
Recording entry not found 


RECORDING IDENTIFY ERROR userid {INVALID|PROTOCOL} 


- Recording identify error userid error identifier 


MACHINE CHECK DURING SYSTEM INITIALIZATION 
[A machine check occurred during system initialization.] or [A MACHINE 
CHECK OCCURRED DURING SYSTEM INITIALIZATION] 


STORAGE PAGE AT xxxxxxxx WILL BE TAKEN OFFLINE WHEN 
POSSIBLE (IF EVER). 
The storage page at xxxxxxxx will be taken offline if possible. 


MACHINE-CHECK WARNING: POWER OR COOLING FAILURE 
IMMINENT 
Machine-check warning: A power or cooling failure is imminent. 


MACHINE-CHECK DEGRADATION (BUFFER OR TLB DAMAGE?). 
A machine-check degradation is present. There may be possible buffer or 
TLB damage. 


SOFT MACHINE-CHECK RECORDING DISABLED 
Recording was disabled for “system recovery” machine check. 


SYSTEM OPERATION CONTINUES 
System operation continues. 


MACHINE CHECKS TOO FREQUENT. REPORTING WILL BE 
SUSPENDED AWHILE. 

Reporting will be suspended temporarily because machine checks are 
occurring too frequently. 


EXPANDED STORAGE ERROR. 
An expanded storage error has occurred. 


PROCESSOR nn SIGNALLING FACILITY DAMAGED, 
{EQUIPMENT|RECEIVER} CH. 

A(n) {equipment|receiver} check has occurred because the signalling facility 
for processor nn is damaged. 


PROCESSOR an {OPERATOR INTERVENING|STOPPED} 
Processor mn {has stoppedloperator is intervening. } 


PROCESSOR nn NOT RESPONSIVE, VARYING OFFLINE 
Processor mn is being varied offline because it is not responsive. 


PROCESSOR nn SEVERE MACHINE CHECK, VARYING OFFLINE 
Processor mn is being varied offline due to a severe machine check. 


SC = sometimes compatible, IC = incompatible, 10 = Release | only. 
Not listed: compatible messages and Release-2-only messages. 
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No. 
9154 


9200 


9201 


9202 


9203 


9204 


9300 


9309 


9406 


9410 


Code 
IC 


IC 


IC 


IC. 


IC 


IC 


IC 


IC 


IC 


IC 


System 


Release | 


Release 2 


Release 1 
Release 2 


Release | 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Release | 


Release 2 


Release | 


Release 2 


Release 1 
Release 2 


Release 1 
Release 2 


Release 1 


Release 2 


Text 


PROCESSOR nn - TOD CLOCK SYNCHRONIZATON FAILURE, 
VARYING OFFLINE 

Processor nn is being varied offline because the TOD clock 1s not 
synchronized. 


SYSTEM RECOVERY FAILURE; CONFIGURATION ERROR 
System recovery failed due to a configuration error. 


SYSTEM RECOVERY FAILURE; RECORDING ERROR 
System recovery failed due to a recording error. 


UNIT RECORD RECOVERY INCOMPLETE 
Unit record recovery is incomplete. 


SYSTEM RECOVERY FAILURE; BLOCK REQUESTED BEYOND 
CHECKPOINT AREA 

System recovery failed during warm start because the block requested is 
beyond the checkpoint area. 


SYSTEM RECOVERY FAILURE; BLOCK REQUESTED BEYOND 
CHECKPOINT AREA 

System recovery failed during a forced start because the block requested is 
beyond the checkpoint area. 


SYSTEM SOFT ABEND ON CPU annn, [ABEND] CODE code [USER 
userid] 
A system soft abend code has occurred on CPU nnnn [for user userid]. 


CP WAS UNABLE TO ALLOCATE A SOFT ABEND DUMP FILE 
CP was unable to allocate a soft abend dump file. 


PREFERRED VIRTUAL MACHINE RECOVERY SUCCEEDED. 
Preferred virtual machine recovery succeeded. 


PREFERRED VIRTUAL MACHINE RECOVERY SUPPRESSED - 
RESERVED FREE STORAGE EXHAUSTED 

Preferred virtual machine recovery has been suppressed because reserved 
free storage is exhausted. 


SC = sometimes compatible, IC = incompatible, 10 = Release 1 only. 
Not listed: compatible messages and Release-2-only messages. 
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Appendix A. Conversion Tools 


IBM is providing two sample EXECs on the product tape to help you convert 
system files from VM/SP HPO to VM/XA SP and applications from VM/SP HPO 
or VM/XA SF to VM/XA SP. The EXECs are: 


¢ COMPSCAN SAMPEXEC, which uses a keyword file to flag keywords in 
VM/SP HPO or VM/XA SF files that may need to be changed. The keyword 
file provided 1s called COMPSCAN SAMPLIST. 


¢ FILECONV SAMPEXEC, which uses keyword files to convert incompatible 
VM/SP HPO parameters to their equivalent VM/XA SP parameters. The 
keyword files that are provided are: 


— CONVSYS SAMPCMDS 
— CONVUCR SAMPCMDS. 


( | IBM provides the files as samples that you can tailor to fit your installation’s 
programming standards and priorities. For example, if your installation does not 
use abbreviations in application programs, you can remove the abbreviations from 
the COMPSCAN SAMPLIST file. 


The following table summarizes the items that need to be converted and the tool that 
can be used. 


ye. To Convert Tool to Be Used 
( ; | VM/SP HPO COMPSCAN SAMPEXEC with COMPSCAN SAMPLIST 
directory 
VM/SP HPO COMPSCAN SAMPEXEC with COMPSCAN SAMPLIST 
DMKRIO to 
HCPRIO 
VM/SP HPO COMPSCAN SAMPEXEC with COMPSCAN SAMPLIST 
DMKSYS to or FILECONV SAMPEXEC with CONVSYS 
if, HCPSYS SAMPCMDS 
( VM/SP HPO FILECONV SAMPEXEC with CONVUCR SAMPCMDS 


class override file 


VM/SP HPO or COMPSCAN SAMPEXEC with COMPSCAN SAMPLIST 
VM/XA SF 
applications 
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Syntax of COMPSCAN 


Use the COMPSCAN SAMPEXEC to flag keywords in a file that may need to be 
converted. The syntax of the COMPSCAN SAMPEXEC is: 


‘COMPSCAN - [ fnl ftl fmi] [ fn2 ft2 fm2 ] [(options] 
[ CMS EXEC A ]__ [ COMPSCAN ft A] 
[HELP ] | 
[? ] 
options: 
[DEPth {n}]  [SEVerity {n}] 
[ {3}] [ {2} ] 
[USERgroup {aaaaaaa}] 
[ {ORPSACG}] 
[HPO] [COMments |] —_ 
[SF2] [NOCOMments ] ey 
[CMS] | 
[SYS] 
[RIO] 
[DIR] 
[SAVe ] 
[NOSAVe | 
where: 
—_ 
fn1 ftl fml Ne” 
CMS EXEC A | | , 
is a list of files that you want to scan. The list must be in the same format as 
the list produced by the CMS LISTFILE command with the EXEC option. The 
default file name is CMS EXEC A. 
{n2 ft2 fm2 
COMPSCAN ft A | 
is the name of the output file from COMPSCAN. The default file name is 
COMPSCAN ft A, where ft is a unique filetype. —_ 
Note: If you specify the name of the output file, you must also specify the input Mag 


file, the name of the list of files you want to scan. 
HELP 
? 
gives you an explanation of the options in COMPSCAN. 


DEPth {n} | 
controls the precision of the COMPSCAN search for incompatible items. 
Because COMPSCAN searches for strings, some strings flagged may have no 
relationship to the actual incompatibility, except for having the same sequence of 
letters. DEPTH determines how specific the string search is. | 
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requests the most specific search and generates the least output. Examples 
of validly-coded CP ATTACH commands that could be found when 
DEPTH is 1 are (6 indicates a blank): 


| 
| 
| 
| 
| (atth 
| 
| 
| 


'attb 
"attb 
battb 


of the DEPTH 1 items plus: 


| 
| requests a medium-level search. For example, the output could include all 
| 
| attachb 


| The default is 2. 


| 
| requests the least specific search and generates the most output. For 

| example, the output could include all of the DEPTH 1 and DEPTH 2 items 
| plus the string: 


| attachedb 


SEVerity {n} 

SEVerity {2} 
indicates the impact of not correcting the incompatibility. COMPSCAN tells 
you what the severity for each flagged item is in the output file. 


( indicates the program will not function as designed. You probably should 
= not attempt to use the program at all. | 
2 . 
indicates the effect of the incompatibility depends on how the program is 
used. 
3 


indicates the program will probably run, but with degraded performance, or 
incompatibilities will probably be obvious during program testing. 


The default is 2. 


USERgroup {aaaaaaa} 

USERgroup {ORPSACG} 
tells COMPSCAN to limit the search to items that affect the user groups you 
specify (aaaaaaa). The letters you specify follow with their definitions. 


O System operator. The system operator can issue all privilege class A 
commands. 
R Resource operator. The system resource operator can issue all 


privilege class B commands. 


P System programmer. The system programmer can issue all privilege 
class C commands. 
S Spooling operator. The spooling operator can issue all privilege class 
D commands. 
( ; A System analyst. The system analyst can issue all privilege class E 
del commands. 
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Cc IBM customer engineer. The IBM customer engineer can issue all 
privilege class F commands. 


G General user. The general user can issue all privilege class G 
commands. 


You can use any combination of user group letters. The default is ORPSACG. 
IBM recommends you always include user group G. 


HPO 
CMS 
SF2 
SYS 
RIO 
DIR 
indicates what incompatibilities you want COMPSCAN to search for: 


e HPO indicates you want to see CP command, DIAGNOSE code, and 
control block incompatibilities between VM/SP HPO Release 5 and VM/XA 
SP. 


¢ CMS indicates you want to see incompatibilities between the CMS 
component in VM/SP. Release 5 and the CMS component in VM/XA SP. 


e SF2 indicates you want to see CP command, DIAGNOSE code, control 
block, and CMS incompatibilities between VM/XA SF Release 2 and 
VM/XA SP. 


e SYS indicates you want to see incompatibilities between the VM/SP HPO 
Release 5 DMKSYS ASSEMBLE file and the VM/XA SP HCPSYS 
ASSEMBLE file. 


e RIO indicates you want to see incompatibilities between the VM/SP HPO 
Release 5 DMKRIO ASSEMBLE file and the VM/XA SP HCPRIO 
ASSEMBLE file. 


e DIR indicates you want to see incompatibilities between the VM/SP HPO 
Release 5 user directory source file and that in VM/XA SP. 


HPO is the default. If you choose HPO, you probably should include the CMS 
option. 


COMments 

NOCOMnments 
indicates whether you want COMPSCAN to scan comment records that begin 
and end on a single line and are the only elements on the line. Comments are 
indicated by * in ASSEMBLE files and delineated by /* and */ in EXEC files. 


SAVe 
NOSAVe 
indicates whether you want COMPSCAN to close the output file after scanning 
each target file. NOSAVe helps performance, but you run the risk of losing 
your data should disk space become exhausted or if the system reloads (IPL). 


| Usage Notes: 


: 1. You can tailor COMPSCAN SAMPEXEC for your own needs. 


2. COMPSCAN uses a keyword file to do its work. The keyword file is called 
[. COMPSCAN SAMPLIST. You should modify this file so that it includes only 
| strings that are likely to be found in your source files. 
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3. COMPSCAN may not find all incompatibilities in a file. Its success depends on 
your installation’s programming practices. COMPSCAN’s usefulness is its | 
ability to give you an estimate of the amount of conversion work required for a 
program. | 


4. COMPSCAN does not find keywords split over lines. 


5. COMPSCAN does not flag normal release-to-release changes or VM/XA SF 
Release 2 externals changed by new functions. Examples are QUERY 
CPLEVEL and changes to the QUERY RDR response as a result of spool file 
limit removal. 


6. COMPSCAN should be used for source code. The output is not meaningful for 
object code. 


7. COMPSCAN flags all instances of a keyword. It is up to you to determine 
whether a flagged record is significant. 


The Output File from COMPSCAN: The layout of the output file from COMPSCAN 
looks like this: 


fn ft fm 
REC# INCOMPATIBLE WORDS S TYPE TEXT OF RECORD..... 


nnnnn daadaa n daa 'aaaaaaaaaaaaaaaaaaaa ' 


where: 


fn ft fm 
is the file name, type, and mode of the file scanned. 


REC# 
specifies the record numbers of records in the file. 


INCOMPATIBLE WORDS 
shows you what string COMPSCAN has flagged in the record. 


S 
is the potential severity of the incompatibility, if uncorrected. 


1 
indicates the program will not function as designed. You probably should 
not attempt to use the program at all. 


indicates the effect of the incompatibility depends on the usage in the 
program. | 


indicates the program will probably run, but with degraded performance, or 
incompatibilities will probably be obvious during program testing. 


TYPE 


indicates the areas of possible incompatibility: 


I 
indicates the incompatibility may exist in the invocation of this function. 
For instance, the string may be a command invocation. 


indicates the incompatibility may exist in the response or in the data 
returned from the function. 
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H | 
indicates the incompatibility may be due to an VM/SP HPO-only item that 
is not used in VM/XA SP. 
F | | 
indicates the incompatibility may be due to a functional difference between 
systems. 
C | 
indicates the incompatibility may be a reference to an an incompatible 
control block. 
2 
indicates the incompatibility may be due to any of the above. For example, 
QUERY variable is flagged because COMPSCAN cannot determine what 
the variable is. 
TEXT 
is the text of the record from fn ft fm which COMPSCAN flagged. -_ 
COMPSCAN records 86 bytes surrounding the keyword. — 


Using the COMPSCAN SAMPEXEC 


Use the COMPSCAN SAMPEXEC to flag keywords in a file that may need to be 
converted. This will help you to determine the impact of converting VM/SP HPO 
system files or VM/SP HPO and VM/XA SF applications. The tool does not 

actually convert the keywords to their VM/XA SP equivalent; it merely flags them. 


* 

To use COMPSCAN, do the following: nee 

1. Look at the COMPSCAN SAMPLIST file and tailor it to your installation’s 

needs. You may also tailor COMPSCAN SAMPEXEC. 

2. Rename COMPSCAN SAMPEXEC to COMPSCAN EXEC. 

3. If the files that you want to scan are compressed or packed, unpack them. 

4. Use the CMS LISTFILE command with the EXEC option to create a list of 
| files to be scanned. ee 

5. Run COMPSCAN with the appropriate options. . re 


6. Analyze the output. 


When analyzing the output, note that not all hits will be definite 
incompatibilities. In many cases: 


¢ Hits will be false. 

¢ Hits will be valid but the usage is compatible. 

e Hits will be valid and the usage may be incompatible. Use “VM/SP HPO 
and VM/XA SP Command Compatibility” on page 105 or “VM/XA SF 
and VM/XA SP Command Compatibility” on page 213 to find out what is 
incompatible. Then, look at the file to determine whether the code or usage 
needs to be changed. 


The following is an example of the output file from COMPSCAN. 
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TEST EXEC Al 
REC# INCOMPATIBLE: WORDS S TYPE TEXT OF RECORD..... 
00002 LINK IF 'LINK TEST 250 250 RR' 
00004 DETACH IRF 'DETACH 251' 
00005 SET EC H 'CP SET EC ON' 
00006 'Q R 'Q FILES' 
00007 TRACE IRF 'CP TRACE 1/0! 
00008 DETACH ‘DETACH 251' 
00009 DIAG 00 CR DIAGRC(14,RNSB,00C) 
00009 DIAG 14 CR DIAGRC(14,RNSB,00C) 
00010 DETACH IRF /* Don't detach 250 yet */ 
Scan completed for file TEST EXEC Al. 


“a NM PM MH WH DY FH PY W 
ee 
A 
ms 


Some hits are obviously insignificant. Due to all the different languages and formats 
possible, there is no definite basis on which to reject a hit. It 1s safer to show all, 
ae and let human judgement prevail. Other hits will require that you look the keyword 
( up in this manual or the VM/XA SP CMS Application Program Conversion Guide to 
Gi determine its significance. 


In the example: 


¢ Record 2 may be significant. The LINK command’s incompatibility involves 
linking multiple exposure devices. If device 250 in this file is not a multiple 
exposure device, there is no problem. 


¢ Record 4 may be significant. COMPSCAN flagged DETACH for invocation 
he (1), function (F), and response (R). The invocation is no problem for this 
( : instance. DETACH was flagged for a possible functional difference, which 
ML involves detaching devices from users. But since this case does not detach a 
device from a user, there is no problem. Finally, DETACH was flagged for an 
incompatibility in the response. You have to verify that the program does not 
attempt to parse the response. 


¢ Record 5 is significant. This is a valid invocation of a VM/SP HPO-only 
command (H), and will not work on VM/XA SP. 


¢ Record 6 may be significant if the program parses the response by column rather 
( = than by word and if it is not prepared for a longer count field. 


¢ Record 7 may be significant. You must determine whether or not the functional 
differences will affect the program. 


¢ Record 8 may be significant. You must use the same judgement as you did for 
record 4. 


¢ Record 9(a) is not significant. This is an example of an invalid hit, because 
COMPSCAN found DIAG 00 and it obviously is not DIAGNOSE X'00'. You 
can safely ignore this one. 


¢ Record 9(b) may be significant, depending on how the program uses the data 
returned. The format of the control block returned may be different. 


¢ Record 10 is not significant. This is obviously a comment. In some cases, 
comments can help you find significant things about the program, since they 
indicate intent or reveal cryptic code. You can avoid scanning full-line 
comments by using the option NOCOMMENTS. 
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Syntax of FILECONV 


Use the FILECONV SAMPEXEC to convert incompatible VM/SP HPO statements 
to the equivalent VM/XA SP statements. : 


The syntax is: 


FILECONV [fnl ftl fml fn2 ft2 fm2 { fn3 ft3 fm3 +) =6£. (QUIET 
[ { CONVUCR SAMPCMDS } 


[ { CONVSYS SAMPCMDS } 
[HELP 
[? 


where: 


fnl ftl fml 
is the file name, type, and mode of the s source file to be converted. 


fn2 ft2 fm2 
is the file name, type, and mode of the output file to be created. 


fn3 f£t3 fm3 
is the file name, type, and mode of the file containing the conversion control 
_ statements. IBM supplies two files: CONVUCR SAMPCMDS and CONVSYS 
SAMPCMDS. Or, you can use a file that you have created. 


QUIET 
is an option to suppress the informational messages detailing the changes made — 
to the source file. This means that you will not be shown the line number of we / 
every line that is being changed. You will still be shown the total number of - 
lines that were changed. 


fo 
ve : vA 


If you do not specify QUIET, all informational messages will be shown. 


HELP 
gives you an explanation of the options in FILECONV. 


gives you an explanation of the options in FILECONV. It is equivalent to the oN 
HELP option. ae. 


Example: 


To convert DMKSYS ASSEMBLE A to HCPSYS ASSEMBLE A, you would issue: 
FILECONV DMKSYS ASSEMBLE A HCPSYS ASSEMBLE A CONVSYS SAMPCMDS 


Using the FILECONV SAMPEXEC 


To use FILECONV, do the following: 


1. Look at the keyword files, CONVSYS SAMPCMDS and CONVUCR 
SAMPCMDS, and tailor them to meet your installation’s needs. You may also 
tailor FILECONV SAMPEXEC. 


2. Rename FILECONV SAMPEXEC to FILECONV EXEC. 


3. If the files that you want to scan are compressed or packed, unpack them. 


4. If you have CMS updates to a file, refresh the source. 
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5. Run FILECONV against the source files to be converted, specifying the sample 
command file that describes the changes. IBM provides two sample command 
files: one for converting DMKSYS (CONVSYS SAMPCMDS) and one for 
converting the VM/SP HPO class override file (CONVUCR SAMPCMDS). 


6. Examine the output file. 


If statements can be converted without requiring your judgement, the EXEC 
converts the original source statement to a comment, marking it with a C, and 
includes the new statement in the line below. 


If statements can be deleted without requiring your judgement, the EXEC 
converts original source statement to a comment, marking it with a D. 


If statements need to be converted but require your judgement, the EXEC marks 
the statement with a W. 


7. Because lines will have been added and deleted, resequence the output file. 


( i Analyzing the Output 


Example: Converting the Class Override File 
The VM/SP HPO class override input file might look like this: 


* 


* CLASS OVERRIDE EXAMPLE INPUT * 
* 
DEST 200 3380 VMRES 
AUTOLOG CLASS=ABL 
cs INDICATE TYPE=0 NEWCLASS=AGU 

( | INDICATE TYPE=A CLASS=EGU 
INDICATE TYPE=G CLASS=GU 
INDICATE TYPE=P CLASS=GU 
QUERY TYPE=R CLASS=BEQ 
QUERY  TYPE=S CLASS=DP 
QUERY TYPE=G CLASS=GU 


After running FILECONYV, the output file would appear as follows: 
* 


( : * CLASS OVERRIDE EXAMPLE OUTPUT * 
* 
*D>ST 200 3380 VMRES 
*C>TOLOG CLASS=ABL 
AUTOLOG NEWCLASS=ABL 
*C>DICATE TYPE=0 NEWCLASS=AGU 
INDICATE IBMCLASS=A NEWCLASS=AGU 
*C>DICATE TYPE=A CLASS=EGU 
INDICATE IBMCLASS=E NEWCLASS=EGU 
*C>DICATE TYPE=G CLASS=GU 
INDICATE IBMCLASS=G NEWCLASS=GU 
*C>DICATE TYPE=P CLASS=GU 
INDICATE IBMCLASS=C NEWCLASS=GU 
*C>ERY TYPE=R CLASS=BEQ 
QUERY IBMCLASS=B NEWCLASS=BEQ 
*C>ERY TYPE=S CLASS=DP 


— QUERY IBMCLASS=D NEWCLASS=DP 
ré | *C>ERY  TYPE=G CLASS=GU 
Baal : QUERY IBMCLASS=G NEWCLASS=GU 
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In the output: 
¢ A C indicates that the statement was changed. The new statement appears in 
the line below. For example: 


*C>TOLOG CLASS=ABL 
AUTOLOG NEWCLASS=ABL 


¢ A D indicates that the statement was deleted. For example: 
*D>ST 200 3380 VMRES 


Example: Converting DMKSYS 
Suppose the VM/SP HPO DMKSYS file looked like: 


DMKSYS CSECT (SAMPLE INPUT) | DMK00010 


SYSOWN VOLID1,VOLID2,VOLID3,VOLID4 DMK00020 
SYSRES SYSVOL=VOLID5, SYSTYPE=3380, SYSNUC=2 , SYSCKP= (30, 10), XDMK@0030 
SYSERR=(27,3) ,SYSCLR=YES DMK00040 
SYSMON USERID=VMAP, XDMK00050 es 
AUTO=NO, XDMKO0060 — 
BUFFS=3 DMK00076 : 
END DMK00080 


After running FILECONV, the output file would appear as follows: 


*C>SYS CSECT (SAMPLE INPUT) DMK00010 
HCPSYS CSECT (SAMPLE INPUT) | DMKO0010 
*C>  SYSOWN VOLID1,VOLID2,VOLID3,VOLID4 | DMK00020 
SYSCPVOL VOLID1,VOLID2,VOLID3,VOLID4 DMKO0020 a 
SYSRES SYSVOL=VOLID5, SYSTYPE=3380,SYSNUC=2,SYSCKP=(30,10), |  XDMK00030 (S 
*C> SYSERR=(27,3) , SYSCLR=YES DMKO0040 ? 
W>  eHPO>=(27,3) ,<HPO>=YES DMKO0040 
*D>  SYSMON USERID=VMAP, XDMKO0050 
# AUTO=NO, XDMKO0060 
* BUFFS=3 DMKO0070 
*D> END DMKO0080 
W>  SYSACNT USERID=<ENTER USERID> 
W>  SYSDUMP 
W>  SYSEREP = 
W>  SYSUVOL —_ 
END rae 


In the output: 


e A C indicates that the statement was changed. The new statement appears in 
the line below. For example: 


*C> SYSOWN VOLID1,VOLID2,VOLID3,VOLID4 
SYSCPVOL VOLID1,VOLID2,VOLID3,VOLID4 


¢ AD indicates that the statement or statements were deleted. For example: 


*D> SYSMON USERID=VMAP, 
: AUTO=NO, 
e BUFFS=3 


e A W indicates that the statement needs to be changed but the change requires 
human judgement. The area that you must change is marked by < >. For 
example, you must enter the userid in the following line. 


W>  SYSACNT USERID=<ENTER USERID> 
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Usage Notes 


Conversion Tools 


<HPO> means that the parameter is VM/SP HPO-only and an equivalent 
parameter does not exist in VM/XA SP. For example: 


“C> SYSERR=(27 ,3) ,SYSCLR=YES 
W> <HPO>=(27,3) ,<HPO>=YES 


Although not shown in this example, statements that extend beyond the screen 
are always marked with a W. 


. You can tailor FILECONV SAMPEXEC to meet your installation’s needs. 
. FILECONV uses a keyword file to do its work. IBM supplies two keyword 


files, called CONVSYS SAMPCMDS and CONVUCR SAMPCMDS, which 
you can tailor according to your needs. 


. FILECONV only works on fixed-length, 80-character records. Columns 72-80 


are reserved for continuation and sequence numbers. 
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Appendix B. Alternative Conversion Strategies 


Read This First 


The information in this appendix has not been submitted to any formal IBM test 
and is distributed on an “as is” basis without any warranty either express or 
implied. The use of this information or the implementation of any of these 
techniques is a customer responsibility and depends on the customer’s ability to 
evaluate and integrate it into the customer’s operational environment. While 
each item may have been reviewed by IBM for accuracy in a specific situation, 
there is no guarantee that the same or similar results will be obtained elsewhere. 
Customers attempting to adapt these techniques to their own environments do so 
at their own risk. 


( There are alternatives to the conversion strategies documented in this manual, but 

hha the alternatives involve the use of unsupported system environments. An 
unsupported system environment is one that IBM does not recommend or service, 
such as an environment in which levels of CMS and CP are mixed. 


Although unsupported, if you cannot convert to VM/XA SP by changing both CP 
and CMS at the same time, you might consider converting to VM/XA SP CMS first 
and running it on your VM/SP HPO or VM/XA SF system. If you experience a 
problem, however, you will have to recreate it on a supported environment before 
reporting it to IBM. 


( We tried running VM/XA SP CMS on VM/SP HPO Release 4.2, VM/sP HPO 
Release 5, and VM/XA SF Release 2. For VM/SP HPO Release 5, we found no 
problems in the environments we ran. On VM/SP HPO Release 4.2 we found: 


e There is no support for full-screen CMS. 


e If you use PARM SAVESYS when loading ([PLing) CMS, the name of the 
named saved system must be exactly 8 characters or you must put X'00' at the 
end of the parameter string. This is due to the way the IPL command initializes 

( . named saved systems. 


To put X'00' at the end of the parameter string, do the following: 
1. Load CMS. Enter: 
IPL 199 STOP PARM SAVESYS name 
where name is the name of the saved system. 
2. Store X'00' at the end of the parameter string in the general registers. 


If you save CMS from an EXEC, you can put the X'00' at the end of the IPL 
statement in the EXEC. 


When running VM/XA SP CMS on VM/XA SF Release 2 at the correct 
maintenance level, we found no problems. To run VM/XA SP CMS on VM/XA SF 
Release 2, be sure to: 


Cc ¢ Apply PUT 8705 
wee _ © Apply the fixes for the following APARs: 
| — VM28326 
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— VM28426 
— VM28757 
— VM28759 
— VM28760 
— VM28761 
— VM28762 
— VM28763 
— VM28767 
— VM28768 
— VM28769 
— VM28770 
— VM28771 
— VM28772 
— VM28773 
— VM28775. 


You may experience other problems when you try running VM/XA SP CMS on c~ 
either VM/SP HPO or VM/XA SF. | \ 
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Appendix C. Object-Code-Only (OCO) and 
Limited-Distribution Modules 


This appendix lists the names of: 


¢ OCO modules in VM/XA SF Release 2, VM/XA SP Release 1, and VM/XA SP 
Release 2 

e¢ Limited-distribution modules in VM/XA SP Release 1 and VM/XA SP Release 
2. 


OCO modules are distributed only in object code form. No source program 
materials are available. 


Table 30 lists CP OCO module names, Table 31 on page 293 lists CMS OCO 
module names, and Table 32 on page 293 lists dump viewing facility OCO module 
names. These tables show the functional areas to which the OCO modules belong. 
Each functional area may or may not also have non-OCO modules. 


Table 30 (Page 1 of 2). CP OCO Modules 


Module Name 


HCPAFF, HCPAIS, HCPVDV, HCPVFD, 
HCPVFE, HCPVFR, HCPVFS, HCPVFV, 
HCPVSM, HCPWIS 


Virtual SIE HCPWAT, HCPWKY, HCPWPR, No Yes | Yes 
HCPWRU, HCPWSH, HCPWSI 

IBM 3092 Processor HCPPCB, HCPPCR, HCPPCV, HCPRFG, 

Controller interface HCPSCP 


CCW translation HCPADP, HCPCCW, HCPCHS, Th 


Functional Area 


Vector facility 


HCPDCP, HCPDCT, HCPDDP, 
HCPDUP, HCPGCS, HCPINS, HCPMDP, 
HCPMD1, HCPMD2, HCPMD3, 
HCPMD4, HCPMDS, HCPMSP, 
HCPTCS, HCPTDD, HCPTMD, 
HCPTMT, HCPTPP, HCPTRM, HCPTTP, 
HCPTUP, HCPTUR, HCPUNT, HCPURP 
(see note 1 on page 292) 


Multiple preferred HCPALE*, HCPASI*, HCPBIE*, Yes (see 

guest support HCPDED*, HCPMCF*, HCPPTT, note 2 
HCPRPC, HCPRQU*, HCPXSC, on 
HCPXSM*, HCPZMG*, HCPZMI*, page 292) 


HCPZMX* 
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Table 30 (Page 2 of 2). CP OCO Modules 


. Module Name 


HCPEDA, HCPEDB, HCPEDC, 
HCPEDD, HCPEDE, HCPEDF, 
HCPEDH, HCPEDI, HCPEDJ, HCPEDK, 
HCPEDM (see note 3), HCPEDN, 
HCPEDR, HCPEDS, HCPEDT, 
HCPEDU, HCPEDV, HCPEDW, 
HCPEDX, HCPEDY 


Hardware instruction HCPVOP 
simulation 
Initialization of HCPRFI 
| hardware features 
ao 
VM dump support HCPVDU, HCPVMD 


Processing for SET HCPSCA 
command 


Functional Area 


| DUMPLOAD 
processing 


Z 


Yes 


Did not Yes 
exist 


o e 


Yes 


e 


ret 


DISPLAY DUMP HCPCDA, HCPCDB, HCPCDC, Yes 
processing HCPCDD 
| Processing for HCPPSF Yes 
QUERY and SET 
commands | 
Console command HCPCFC Yes 
support 

Eab . 


SEND command HCPSEC 
processing | 
exist 


Notes: 


1. The module names shown for CCW translation are the VM/XA SP names. The module names used 
in VM/XA SF Release 2 include three that are the same as in VM/XA SP although the modules 
themselves have been rewritten (HCPCCW, HCPTRM, and HCPUNT) and five that are not used in 
VM/XA SP (HCPCON, HCPDSM, HCPOPC, HCPRDS, and HCPTPS). 


. Names marked with an asterisk (*) did not exist in the initial release of VM/XA SP Release 1 but 
were introduced in an enhancement to that release. 


. The module names shown for DUMPLOAD processing are the VM/XA SP Release 2 names. The 
module names used in VM/XA SF Release 2 and VM/XA SP Release 1 include HCPEDM, but the 
module is rewritten for VM/XA SP Release 2. 
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Table 31. CMS OCO Modules 


Functional Area Module Name 


Vector facility DMSINV 


DCA enhanced DMSBOF, DMSBUS, DMSCCM,, 
connectivity DMSCIA, DMSDFT, DMSICT, DMSPBS, 
enhancement DMSSAP, DMSSNC, DMSSUP, DMSTRC 


Note: CMS is not supported in VM/XA SF Release 2. 


Table 32. Dump Viewing Facility OCO Modules 


Functional Area Module Name 


Dump viewing facility All modules except HCSTBL. (Dump 
viewing facility module names begin with the 
letters HCS.) 


imited-Distribution Modules 
The following materials are available for limited-distribution modules: 


¢ Object code 
e Microfiche of the assembler-generated source/object program listing and 
compiler-generated information listing. 


Machine-readable source code is not available. 


IBM maintains limited-distribution modules at the object-code level. When 
necessary, the module object code is either fully replaced or it 1s updated by using 
the VER and REP control records under the patch facility or the CMS ZAP 
command. The patch facility is described in the VM/XA SP Installation and Service 
manual and the ZAP command is described in the VM/XA SP CMS Command 
Reference. 


This section lists the names of CP, CMS, and GCS limited-distribution modules. 
The names are in alphabetic order by component, not by functional area. Refer to 
the microfiche to determine functional areas. 


There are no limited-distribution modules in VM/XA SF Release 2. 
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CP Limited-Distribution Modules 


CP 
Module 
Name 


HCPCBI 
HCPCNC 
HCPERM 
HCPLDS 
HCPLMT 


HCPMCT 
HCPMNA 
HCPMNB 
HCPMNC 
HCPMND 


HCPMNE 
HCPMNF 
HCPMNG 
HCPMNH 


HCPMNI — 


HCPMNJ 
HCPMNK 
HCPMNL 
HCPMNM 
HCPMNN 


HCPMNO 
HCPMNP 
HCPMNQ 
HCPMNR 
HCPMNS 


HCPMNT 
HCPMNU 
HCPMNV 
HCPMNW 
HCPMNX 


HCPMNY 
HCPMNZ 
HCPMOB 
HCPMOC 
HCPMOD 


HCPMOE 
HCPMOF 
HCPMOG 
HCPMOH 
HCPMOI 
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Limited 


Distribution 


in VM/XA SP 


Release 1 


Limited 
Distribution 


in VM/XA SP 


Release 2 


Yes 


nites ecient |, Macias + 1S) ace eens) aoe 


CP 
Module 
Name 


HCPMOJ 

HCPMOK 
HCPMOM 
HCPMON 
HCPMOO 


~HCPMOP 


HCPMOQ 
HCPMOR 
HCPMOS 
HCPMOT 


HCPMOU 
HCPMOV 
HCPMOX 
HCPMOY 
HCPMOZ 


HCPMXU 
HCPREI 
HCPTSA 
HCPTSB 
HCPTSC 


HCPTSD 


~HCPTSF 


HCPTSG 
HCPTSH 
HCPTSJ 


HCPTSK 
HCPTSN 
HCPTSO 
HCPTSP 
HCPTSQ 


HCPTSR 
HCPTSU 
HCPTSW 
HCPTSX 
HCPTSY 


HCPTUD 
HCPTUT 
HCPUTT 
HCPUUR 
HCPVCY 


Limited 
Distribution 


in VM/XA SP 


Release | 


Yes 
Yes 
Yes 
Yes 
No 


Limited 
Distribution 


in VM/XA SP 


Release 2 


| CMS Limited-Distribution Modules 

| The modules named below have limited distribution in VM/XA SP Release 1 and 
| 

| 


VM/XA SP Release 2 except for VMFLDS, which has limited distribution in 
VM/XA SP Release 2 only. CMS is not supported in VM/XA SF Release 2. 
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| CMS | CMS | CMS | CMS 
| Module | Module | Module | Module 
| Name | Name | Name | Name 
| DMSADD | DMSMGE | DMSRTE | DMSWRT 
| DMSALA | DMSMGM | DMSSCA | DMSWST 
| DMSALC | DMSMGX | DMSSCL | DMSWVC 
| DMSAST | DMSMIN | DMSSEF | DMSWVD 
| DMSBCT | DMSMKS | DMSSEG | DMSWVE 
| DMSBLG | DMSPAR | DMSSHO | DMSWVL 
| DMSCCP | DMSPBK | DMSSIZ | DMSWVQ 
— | DMSCCS | DMSPCA | DMSSLG | DMSWVS 
( | | DMSCCX | DMSPCB | DMSSMG | DMSWVT 
= | DMSCDI | DMSPCC | DMSSRE | DMSWVX 
| DMSCLN | DMSPCL | DMSSRH | VMFLDS 
| DMSCLR | DMSPCR | DMSSRP 
| DMSCRT | DMSPCT | DMSSRQ 
| DMSCST | DMSPCW | DMSSTC 
| DMSCUR | DMSPGM | DMSSTK 
| DMSDCS | DMSPKR | DMSUSR 
co | DMSDEF | DMSPKT | DMSUST 
( . | DMSDEL | DMSPLC | DMSVLD 
_ | DMSDEV | DMSPMD | DMSWAT 
| DMSDIE | DMSPPL | DMSWBX 
| DMSDRO | DMSPPO | DMSWEN 
| DMSDRP | DMSPRB | DMSWEX 
| DMSEVC | DMSPRI | DMSWID 
DMSGET | DMSPRJ | DMSWIF 
DMSGRQ | DMSPSM | DMSWIM 
( : DMSGTS | DMSPST | DMSWIN 
_ DMSGTU | DMSPTC | DMSWIO 
| DMSHDS | DMSPTK | DMSWIR 
| DMSHID | DMSPTL | DMSWIS 
DMSHLC | DMSPTR | DMSWIT 
DMSHLL | DMSPTT | DMSWLR 
DMSHLM | DMSPUT | DMSWLW 
DMSHLR | DMSPVF | DMSWMI 
DMSHLT | DMSQRF | DMSWMM 
| DMSHLZ | DMSQRG | DMSWMO 
| DMSIAC | DMSQRH | DMSWMU 
| DMSLMX | DMSREF | DMSWMX 
| DMSMAX | DMSRES | DMSWQI 
| DMSMGC | DMSRLD | DMSWQM 
| DMSMGD | DMSROU | DMSWRD 


GCS Limited-Distribution Modules 
The modules named below have limited distribution in VM/XA SP Release 2 on 
GCS does not exist in VM/XA SP Release 1. 


GCS _ 
Module 
Name 


CSIABD 
CSIAES 
CSIANM 
CSIANT 
CSIATT 


CSICMD 
CSICMH 
CSICOM 
CSICON 
CSIDIE 


CSIDSP 
CSIDUM 
CSIDUQ 
CSIDUR 
CSIENQ 


CSIEST 
CSIFNC 
CSIFSV 
CSIGFC 
CSIGFD 


CSIGFE 
CSIGFI 

CSIGFT 
CSIGIA 
CSIGII 


CSIGIM 
CSIGIN 
CSIGIP 
CSIGIT 
CSIGIU 


CSIGIX 
CSIGSU 
CSIGSV 
CSIGSW 
CSIGSX 


CSHAL 
CSIIDS 
CSHEX 
CSUFL 
CSUFT 
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GCS 
Module 
Name 


CSITU 
CSHNI 
CSIINS 
CSHPR 
CSUTA 


CSIITE 
CSUTL 
CSIITP 
CSITUE 
CSHUUI 


CSHUM 
CSIUS 
CSITUX 
CSIVL 
CSUXT 


CSILAC 
CSILDC 
CSILLK 
CSIMSG 
CSIMTA 


CSIMTB 
CSINUC 
CSINXT 
CSIPMA 
CSIPMB 


CSIPMC 
CSIPMD 
CSIPMI 
CSIPML 
CSIPMM 


CSIPMN 
CSIPMR 
CSIPMS 
CSIPNC 
CSIPND 


CSIPNI 
CSIPNM 
CSIPNP 
CSIPNX 
CSIQRD 


GCS 
Module 
Name 


CSIQRL 
CSIQRQ 
CSIQRR 
CSIRET 
CSIRPY 


CSISDT 
CSISDX 
CSISUP 
CSITIH 

CSITIM 


CSIVAL 
CSIWAI 
CSIWTR 
CSTYTD 
CSIYTE 


CSIYTG 
CSIYTI 
CSIYTO 
CSTYTS 
CSTYTW 


CSTYTX00 


DSIEXI15 


—— 
‘sn aN 


Summary of Changes 


| Technical changes throughout this manual] are indicated by vertical bars to the left 
| of the changed material. 


Second Edition 
| Form of Publication: SC23-0357-1 


| Level of Product: VM/XA System Product Release 2 
| Date of Publication: September 1988 


| Changes to this publication: 
( | ¢ For those converting from VM/SP HPO Release 4.2 or 5 


| Part 1, “Converting from VM/SP HPO to VM/XA SP” has been updated to the 
| VM/XA SP Release 2 level. 


| e¢ For those converting from VM/XA SF Release 2 


| Part 2, “Converting from VWM/XA SF to VM/XA SP” has been oes to the 
| VM/XA SP Release 2 level. 


| ¢ For those migrating from VM/XA SP Release 1 
( | Part 3, “Migrating from VM/XA SP Release 1 to Release 2” has been added. 
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Glossary 


A 


automatic software re-IPL. The process by which 
the control program attempts to restart the system 
after abnormal termination. This process does not 
involve the hardware IPL process. See also 
virtual = real machine recovery. 


C 


CCS. Console communication services. 
CCW. Channel command word. 


channel command word (CCW). A doubleword 
structure that directs an I/O operation on a device 
or channel and includes pointers to any storage 
areas associated with the operation. One or more 
CCWs make up a channel program. 


CMS. Conversational monitor system. 


console communication services (CCS). A group of 
CP routines that interface with the VTAM service 


machine, providing full VM/XA SP console 


capabilities for SNA/CCS terminal users. 


control program (CP). The component of VM/XA 
SP that manages the resources of a single 
System/370-Extended Architecture system so that 
multiple computing systems appear to exist. Each 
virtual machine is the functional equivalent of 
either a System/370 computing system or a 
System/370-Extended Architecture computing 
system. 


conversational monitor system (CMS). The 
component of VM/XA SP that, as a virtual 
machine operating system, provides interactive 
time-sharing. CMS allows users to communicate 
with the system and with each other, to create and 
edit files, and to develop and run application 
programs. It operates in either System/370 mode or 
370-XA mode under the control of CP. 


CP. Control program. 


D 


DCSS. Discontiguous saved segment. 


directory. A CP disk file that includes an entry for 
each user in the system. The entry defines the 
characteristics of the user’s initial virtual machine 
configuration. These characteristics include the 
userid, the password, normal and maximum 
allowable virtual storage, virtual device definitions, 
the privilege class, the dispatching priority, logical 
line editing characters, and the account number. 


discontiguous saved segment (DCSS). A saved 
segment that occupies one or more 
architecturally-defined segments. It begins and ends 
on segment boundaries. It is accessed by its own 
name. Contrast with member saved segment. See 
also saved segment, segment, segment space. 


dump viewing facility. A VM/XA SP component 
that allows users to display, format, and print data 
interactively from CP hard and soft abend, 
stand-alone, and virtual machine dumps, and to 
process CP trace table data stored on tape or ina 
system trace file. 


dynamic paging area. The area of real storage 
allocated by CP for V=V machine paging. This 
area also contains CP nonresident modules, CP 
control blocks, CP trace tables, free storage pages, 
and the alternate processor’s prefix storage areas. 


E 


Expanded Storage. Optional integrated high-speed 
storage. In VM/XA SP, Expanded Storage may be 
shared by CP and one or more virtual machines. It 
may also be dedicated to CP or to a particular 
virtual machine. 


ce 


full-pack minidisk. A virtual disk that contains all 
of the addressable cylinders of a real DASD 
volume. 


full-screen mode. In VM/XA SP, the environment 


in which an entire 3270 display screen is under the 
control of a program running in a virtual machine. 
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G 


GCS. Group control system. 


group control system (GCS). The component of 
VM/XA SP that, as a virtual machine supervisor, 
executes in a group of System/370 virtual machines 
under CP control to provide an interface that helps 
support a native Systems Network Architecture 
(SNA) network. 


guest. An operating system running in a virtual 
machine managed by the VM/XA SP control 
program. Contrast with host. | 


guest real storage. The storage that appears real to 
the operating system running in a virtual machine. 
Contrast with guest virtual storage, host real 
storage, and host virtual storage. 


guest virtual storage. The storage that appears 
virtual to the operating system running in a virtual 
machine. Contrast with guest real storage, host real 
storage, and host virtual storage. 


H 


host. The VM/XA SP control program in its 
capacity as manager of a virtual machine in which 
another operating system is running. Contrast with 
guest. 


host real storage. The storage that appears real to 
the control program. If VM/XA SP is running 
native, this is real storage; if VM/XA SP is running 
in a virtual machine, this is virtual storage. 
Contrast with guest real storage, guest virtual 
storage, and host virtual storage. 


host virtual storage. The storage that appears 
virtual to the control program. Contrast with guest 
real storage, guest virtual storage, and host real 
storage. 


image library. A set of modules, contained in a 
system data file, that define the spacing, characters, 
and copy modification data that a 3800 printer uses 
to print a spool file or that define the spacing and 
character set that an impact printer uses to print a 
spool file. See also system data file. 
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inter-user communication vehicle (IUCV). A 
generalized CP interface that facilitates the transfer 
of data among virtual machines. 


IUCV. Inter-user communication vehicle. 


member saved segment. A saved segment that 
begins and ends on a page boundary. It belongs to 
up to 64 segment spaces and is accessed either by 
the segment space name or by its own name. 
Contrast with discontiguous saved segment. See 
also saved segment, segment, segment space. 


missing interrupt handler. A CP function for 
detecting and dealing with real I/O operations that 
do not complete within a specified time. 


multiple preferred guests. A VM/XA SP facility 


that supports up to six preferred virtual machines 


when the Processor Resource/System Manager 
(PR/SM) feature is installed in the real machine. 
See also preferred virtual machine. 


named saved system (NSS). A copy of an operating 
system that a user has named and retained in a 
system data file. The user can load the operating 
system by its name, which is more efficient than 
loading it by device number. See also discontiguous 
saved segment, member saved segment, saved 
segment, segment space, system data file. 


NSS. Named saved system. 


p 


pageable virtual machine. Synonymous with 
virtual = virtual machine. 


preferred virtual machine. A virtual machine that 
runs in the V=R area. CP gives this virtual 
machine preferred treatment in the areas of 
performance, processor assignment, and I/O 
interrupt handling. See also multiple preferred 
guests, virtual = fixed machine, virtual = real area, 
virtual = real machine. 


Processor Resource/Systems Manager (PR/SM). A 
separately orderable feature available with 3090E 
processors that provides for logical partitioning of 


- 


we 
( 
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the real machine and support of multiple preferred 
guests. See also multiple preferred guests. 


PR/SM. Processor Resource/Systems Manager. 


R 


real system operator. Any user who loads and runs 
VM/XA SP in the real machine. Contrast with 
virtual machine operator. 


S 


saved segment. One or more pages of storage that 
have been named and retained in a system data file. 
See also discontiguous saved segment, member 


saved segment, segment, segment space, system data 
file. 


segment. In System/370 architecture, 64 kilobytes 
of storage. In 370-XA architecture, 1 megabyte of 
storage. See also saved segment. 


segment space. A saved segment composed of up 
to 64 member saved segments accessed by a single 
name. A segment space occupies one or more 
architecturally-defined segments; it begins and ends 
on segment boundaries. A user with access to a 
segment space has access to all of its members. See 
also discontiguous saved segment, member saved 
segment, saved segment, segment. 


service virtual machine. A virtual machine that 
provides system services. These services include 
accounting, error recording, monitoring, and those 
provided by supported licensed programs. 


SMSG function. A CP function that allows a 
virtual machine to send a special message to 
another virtual machine programmed to accept and 
process the message. See also special message. 


SNA. Systems Network Architecture. 


SNA/CCS terminal. Any terminal accessing 
VM/XA SP that is managed by a VTAM service 
machine. 


special message. A data transmission, made up of 
instructions or commands, sent from one virtual 
machine to another via the SMSG function. A 
special message is processed by the receiving virtual 
machine and does not appear on the receiver’s 
console. See also SMSG function. 


/ 
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spool file. A collection of data along with CCWs 
for processing on a unit record device. Contrast 
with system data file. 


SVC 76. In VM/XA SP, a supervisor call 
instruction that records the error incidents 
encountered by certain operating systems running in 
virtual machines. When a virtual machine 
operating system issues an SVC 76, VM/XA SP 
translates the virtual storage and I/O device 
addresses to real addresses, records the information 
on the VM/XA SP error recording virtual machine, 
and returns control to the issuing virtual machine. 
This interface bypasses the virtual machine’s own 
error recording routine, and avoids duplicate error 
recording. 


System/370 mode. A virtual machine operating 
mode in which System/370 functions are simulated. 
Contrast with 370-XA mode. 


system data file. A collection of data associated 
with a particular function. Types of system data 
files include saved segments, NSSs, UCR files, 
image libraries, and system trace files. Because a 
system data file contains no CCWs, it cannot be 
processed on a unit record device. Contrast with 
spool file. 


system hold status. A spool file status that prevents 
a file from being printed, punched, or read until the 
real system operator releases it. Contrast with user 
hold status. 


system trace file. A type of system data file that 
contains CP or virtual machine trace data. 


Systems Network Architecture (SNA). The 
description of the logical structure, formats, 
protocols, and operational sequences for 
transmitting information units through, and 
controlling the configuration and operation of, 
networks. 


U 


UCR file. User class restructure file. 
unit record device. A reader, a printer, or a punch. 
user class restructure file (UCR file). A type of 


system data file that contains information used to 
override the IBM-defined privilege class structure of 
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CP commands, DIAGNOSE instruction codes, and 
certain CP system functions. 


user directory. See directory. 


user hold status. A spool file status that prevents a 
file from being printed, punched, or read until the 
file owner releases it. Contrast with system hold 
Status. 


V 


Vector Facility (VF). A hardware feature that 
provides synchronous instruction processing for 
high-speed manipulation of fixed-point and 
floating-point data. 


VF. Vector Facility. 
V=F machine. Virtual= fixed machine. 


virtual = fixed machine (V=F machine). A 
preferred virtual machine with a fixed, contiguous 
area of host real storage that does not start at page 
0. CP provides performance enhancements for this 
virtual machine. See also multiple preferred guests, 
preferred virtual machine, virtual =real area, 
virtual = real machine, virtual = virtual machine. 


virtual machine. In VM/XA SP, a functional 
equivalent of either a System/370 computing system 
or a System/370-Extended Architecture computing 
system. Each virtual machine is controlled by an 
operating system. VM/XA SP controls the 
concurrent execution of multiple virtual machines 
on an actual System/370-Extended Architecture 
system. 


Virtual Machine/Extended Architecture System 
Product (VM/XA SP). An operating system that 
allows multiple IBM System/370 and 370-XA 
operating systems to run simultaneously on a single 
370-XA processor. The multiple systems may be 
used for production, testing, developing application 
programs, maintenance, and migration. VM/XA 
SP also provides a high-capacity interactive 
environment. There are four components: the 
control program (CP), the conversational monitor 
system (CMS), the dump viewing facility, and the 
group control system (GCS). 


virtual machine operator. Any user who loads and 


runs an operating system in a virtual machine. 
Contrast with real system operator. 
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virtual = real area (V=R area). A fixed, contiguous 
section of real storage, starting at page 0, in which 
preferred virtual machines execute. CP does not 
page this storage. See also preferred virtual 
machine, virtual = fixed machine, virtual = real 
machine. | 


virtual = real machine (V=R machine). A preferred 
virtual machine with a fixed, contiguous area of 
host real storage that starts at page 0. CP provides 
performance enhancements and an automatic 
recovery facility for this virtual machine. See also 
multiple preferred guests, preferred virtual machine, 
virtual = real area, virtual=real machine recovery, 
virtual = virtual machine. 


virtual = real machine recovery (V =R machine 
recovery). A CP function that allows the V=R 
machine to resume operation after most CP 
abnormal terminations. When possible, the facility 
reestablishes the V=R machine environment, 
allowing the operating system running in that 
virtual machine to perform its own recovery 
processes. See also automatic software re-IPL. 


virtual = virtual machine (V=V machine). A virtual 
machine that runs in the dynamic paging area. CP 
pages this virtual machine’s guest real storage in 
and out of host real storage. See also dynamic 
paging area, virtual = fixed machine, virtual = real 
machine. 


virtual supervisor state. A condition, controlled by 
a virtual machine’s current PSW, during which the 
control program allows the virtual machine to issue 
input/output and other privileged instructions. 
When these instructions are not emulated, the 
control program intercepts these instructions and 
simulates their functions for the virtual machine. 


virtual wait time. The period during which the 
control program suspends the processing of a 
program while a required resource is unavailable. 


VM/XA SP. Virtual Machine/Extended 
Architecture System Product. 


VTAM service machine. A collection of networking 
programs running in a virtual machine that, 
together with the CP console communication 
services (CCS) routines, provide full VM/XA SP 
console capabilities for SNA/CCS terminal users. 

A VTAM service machine contains either (1) 
VM/VTAM with VSCS running as an application 
under control of GCS, or (2) VM/VCNA running 


ae, 


ae of 


as a VTAM application under control of the VSE 
or VSI operating system. 


V=R area. Virtual=real area. 
V=R machine. Virtual=real machine. 


V=R machine recovery. Virtual=real machine 
recovery. 


V=V machine. Virtual = virtual machine. 


Numerics 

370 mode. Synonym for System/370 mode. 
370-XA mode. A virtual machine operating mode 
in which System/370-Extended Architecture 


functions are simulated. Contrast with System/370 
mode. 
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Bibliography 


This bibliography gives the names and order numbers of microfiche and publications 
about VM/XA System Product and related products. 


VM/XA System Product Microfiche 


You can order microfiche listings that contain code. The order numbers for the 
microfiche are: 


Order No. Description 
LYC7-0330 VM/XA System Product: CP listings 
LYC7-0331 VM/XA System Product: CMS listings 
a LYC7-0332. VM/XA System Product: GCS listings 
( | LYC7-0334 VM/XA System Product: dump viewing facility listings. 


VM/XA System Product Publications 


The publications are shown in Figure 24 on page 306. You can order any of them 
by their individual order numbers or you can order most of them as a group by 
using a single order number, SBOF-0260. SBOF-0260 provides: 


¢ Enough three-ring binders to hold the publications 
e Spine and cover inserts for the binders. 


Note: The Release 2 editions of VM/XA SP General Information and the VM/XA 
SP Conversion Notebook are available prior to general availability of VM/XA 
SP Release 2. Release 2 editions of other publications are available at the 
same time as general availability of VM/XA SP Release 2. | 


C e All unlicensed publications (order numbers that do not begin with LY) 
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